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OPERATORS SAFETY SUMMARY 


This general safety information is for both operating and servicing personnel. Specific warnings and cautions will be found 
throughout the manual where they apply, but may not appear in this summary. 


TERMS 


IN THIS MANUAL 


CAUTION statements identify conditions or practices that 
can result in damage to the equipment or other property. 


WARNING statements identify conditions or practices that 
can result in personal injury or loss of life. 


AS MARKED ON EQUIPMENT 
CAUTION indicates a personal injury hazard not immedi- 
ately accessible as one reads the marking, or a hazard to 


property including the equipment itself. 


DANGER indicates a personal injury hazard immediately 
accessible as one reads the marking. 


SYMBOLS 


IN THIS MANUAL 


This symbol indicates where applicable cautionary or 
other information is to be found. 


As Marked on Equipment 
# DANGER high voltage. 
& Protective ground (earth) terminal. 


/\ ATTENTION — refer to manual. 


C1) Refer to manual. 
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POWER SOURCE 


This product is designed to operate from a power source 
that does not apply more than 250 volts rms between the 
supply conductors or between either supply conductor and 
ground. A protective ground connection by way of the 
grounding conductor in the power cord is essential for safe 
operation. 


GROUNDING THE PRODUCT 


This product is grounded through the grounding conductor 
of the power cord. To avoid electrical shock, plug the power 
cord into a properly wired receptacle before connecting to 
the power input or output terminals. A protective ground 
connection by way of the grounding conductor in the power 
cord is essential for safe operation. 


DANGER ARISING FROM 
LOSS OF GROUND 
Upon loss of the protective-ground connection, all accessi- 


ble conductive parts (including knobs and controls that may 
appear to be insulating) can render an electric shock. 


USE THE PROPER POWER CORD 


Use only the power cord and connector specified for your 
product. 


Use only a power cord that is in good condition. 


Refer cord and connector changes to qualified service 
personnel. 
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USE THE PROPER FUSE 

To avoid fire hazard, use only the fuse specified in the parts 
list for your product, and which is identical in type, voltage 
rating, and current rating. 

Refer fuse replacement to qualified service personnel. 

DO NOT OPERATE IN 

EXPLOSIVE ATMOSPHERES 

To avoid explosion, do not operate this product in an atmo- 


sphere of explosive gases unless it has been specifically 
certified for such operation. 
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DO NOT REMOVE COVERS OR PANELS 


To avoid personal injury, do not remove the product covers 


or panels. Do not operate the product without the covers 
and panels properly installed. 
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Section 1 


INTRODUCTION 


ABOUT THIS MANUAL 


This manual introduces you to the TEKTRONIX 4115B 
Computer Display Terminal with firmware version 4.0 and 
greater. The manual discusses in detail the features and 
Capabilities of the terminal from a typical operator’s view- 
point. The organization of the manual is as follows: 


Contains introductory material about the 
terminal and its features and capabilities. 


Section 1 


Section 2 


Discusses various peripheral devices that 
may be used with the terminal, including 
connection information and typical terminal 
operations involving these devices. Also 
discusses files and file transfers. 


Section 3 


Section 4 Discusses GIN (Graphic Input) mode. 
Discusses the various terminal communica- 
tions modes and parameters. The correct 
parameter settings are necessary for com- 
munications with the host and peripheral 
devices. Table 5-1 summarizes these param- 
eters for handy reference. 


Section 5 


Section 6 Contains a command dictionary of all setup 
commands that an operator will normally 


need to use. 


Contain various types of reference informa- 
tion: error messages, power-up Sequence, 
self test, optional keyboards, ASCII code 
charts, and escape sequence commands . 
normally issued from the host. Appendix F 
includes a sample session with the terminal 
to acquaint you with its main features. 


Appendices 
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Discusses all external controls and indicators. 


Before reading this manual, please complete the exercises 
in Appendix F (or in the 4115B Introduction Brochure — the 
same exercises are contained in each document) to 
become familiar with the basic features and operation of the 
terminal. 


RELATED DOCUMENTATION 


Additional documentation for the terminal is contained in 
the following: 


@ 4115B Introduction Brochure 
@ 4110 Series Host Programmer’s Reference Manual 
@ 4110 Series Command Reference Manual 


@ 4]]5B Computer Display Terminal Service Manual, 
Volumes I and 2 


®@ 640-0219-00/01 Display Module Service Manual 


In addition, some 4115B options have their own separate 
manuals. Consult the following if needed: 


@ 4115B Option 3A DMA Interface Instruction Manual 


@ 4110 Series Option 2 Current Loop Interface Instruction 
Manual 


@ 4/10 Series Option 10 Three Port Peripheral Interface 
Instruction Manual 


@ 41/10 Series Option 13/14 Graphic Tablet Instruction 
Manual 


@ 1/19-0977-01/03 Flexible Disk Drive Instruction Manual 
@ 4110B Series Mass Storage Service Manual 
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INTRODUCTION 


GENERAL DESCRIPTION 


The 4115B Computer Display Terminal (Figure 1-1) is a 
microprocessor-controlled color graphics and alphanumeric 
terminal. The terminal consists of a 19-inch display module 
mounted on a pedestal base that contains most of the termi- 
nal circuitry. The low-profile keyboard attaches to the pedes- 
tal by a coiled wire cable. It sits in a convenient slide-out tray 
mounted in the pedestal, but it can also be removed and 
placed for maximum operator comfort. 


The display module contains a 19-inch diagonal color ras- 
ter-scan crt with 1024 x 1280 pixel resolution. The termi- 
nal’s internal coordinate space, however, provides more 
than 4 billion addressable points. Because of this high inter- 
nal data resolution, the terminal’s zoom and pan features 
can be used to expand a small portion of the graphics dis- 
play (several times if desired) while maintaining resolution 
and quality. Because the rest of the display is preserved in 
memory, it can be restored to the screen at any time. 


The terminal is designed for advanced high-speed color 
graphics information processing. It contains a firmware- 
resident command set that includes several dozen graphics 
commands. Using these commands, either stored locally or 
from a host-resident software program, the terminal can 
create color graphic images, display and modify those 
images, and transmit them back to the host computer, store 
them on a local mass-storage device, or produce high- 
quality color hard copies of the screen displays. 


Color is one of the main features of the 4115B. The stand- 
ard terminal can display 16 colors simultaneously. With 
Options 22 and 23, the terminal can display up to 256 colors 
on the screen at one time, selected from a palette of over 16 
million colors. Option 09 provides an interface to a TEK- 
TRONIX 4691 Color Graphics Copier for copies of the entire 
screen or of selected portions of the display. 


The terminal also responds to text-editing commands speci- 
fied in or compatible with ANSI Standard X3.64 (ISO Stand- 
ard 6429). This allows the use of several common screen- 
oriented text editors, making the terminal available as an 
alphanumeric terminal. As with graphics, the use of color 
can enhance the information content and impact of text. 


In addition to the commands that communicate with the 
host computer, the terminal’s Setup mode allows the use of 
English-style commands to initialize many terminal operat- 
ing parameters locally. Setup commands are discussed in 
detail in Section 6 of this manual. 
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SOFTWARE SUPPORT 


The 4115B terminal is compatible with 4010 Series graphics 
software. In most cases, a program written for a Tektronix 
4010 Series terminal can be executed unmodified on the 
4115B. Modifications can be made to take advantage of the 
new features of this terminal, including color, use of the 
dialog area, new features of GIN (Graphic Input — see 
Section 4), and new graphics features such as segments 
and panels. The 4115B can be driven by the following 
TEKTRONIX PLOT 10 products: 


@ Interactive Graphics Library 

@ Terminal Control System and associated packages 

@ Easy Graphing 

If you are already using 4110 Series software, the transition 
is even simpler. You may want to enhance existing 4110 
Series programs to take advantage of the 4115B’s wider 


range of color and larger coordinate space. But any 4110 
Series software should run on the 4115B as is. 


THE 4115B PACKAGE 


The standard 4115B Computer Display Terminal package 
contains: | 


@ The 4115B Computer Display Terminal — display unit, 
pedestal, and keyboard 


@ The 4/1/5B Introduction Brochure 


@ The 4//5B Computer Display Terminal Operators 
Manual 


@ The 41/10 Series Host Programmers Manual 

@ The 4/10 Series Command Reference Manual 
@ Power cord set (two cords) 

@ Six function key overlays 

@ Display cables (3 BNC and 1 control) 

@ One RS-232-C host port cable 

The following are optional accessories (see the appendices 
for ordering information): 

@® 4115B Raster Extender board 

@ 411X Logic Extender board 

@ Function key overlays 


@ RS 232 loop-back connector 
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4115B Service Manual, Volume 1 

4115B Service Manual, Volume 2 

640-0219-00/01 Display Module Service Manual 
4115B Option 3A DMA Interface Instruction Manual 
4110 Series Option 10 Service Manual 


4110 Series Option 13/14 Graphics Tablet Instruction 
Manual 


@ 4110B Series Mass Storage Service Manual (Option 42, 43 


or 45) 


@ 119-0977-01/03 Flexible Disk Drive Instruction Manual 
(Option 42 or 43) 


@ 4115B Display Module Adjustment Graticule 


The terminal has the following options: 


Option 01 Extended Communications Interface 
(ECC) — includes half-duplex and Block mode 

OptionO2 Current Loop Interface 

Option 2A Additional 256K Bytes of RAM with ECC 

Option2B = Additional 512K Bytes of RAM with ECC 

Option3A DMA Interface (for PDP 11 and VAX 
computers) 

Option3B = 30’ cable for Option 3A 

Option4A United Kingdom Keyboard 

Option4C Swedish Keyboard 

Option4F  Danish/Norwegian Keyboard 

Option4K Katakana Keyboard 

Option09 4690 Series Color Hard Copy Unit Interface 

Option10  Three-Port Peripheral Interface (8PPI) 

Option13 Graphic Tablet (size: 11 x 11”) with 
Controller 

Option14 Graphic Tablet (size: 30 x 40”) with 
Controller 

Option 22 Additional 2 Planes Display Memory. 
Increases the number of available bit-planes 
from four to six. 

Option 23 Additional 4 Planes Display Memory. 
Increases the number of available bit-planes 
from four to eight. 
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Option 28 


Option 29 


Option 31 


Option 42 


Option 43 


Option 45 
Option 49 
Option 52 


Option A1 


Option A2 


Option A3 


Option A4 


Option A5 


INTRODUCTION 


Additional 256K Bytes of RAM. Includes two 
RAM Controller boards with eight RAM Array 
boards installed. 


Additional 512K Bytes of RAM. Includes four 
RAM Controller boards with sixteen RAM 
Array boards installed. 


Autoconverged Display. Replaces standard 
display with 640-0219-01. 


Single Flexible Disk and Controller (includes 
Option 45 with Mass Storage Interface 
connector) 


Dual Flexible Disk and Controller (includes 
Option 45 with Mass Storage Interface 
connector) 


Mass Storage Interface 
Rental Identification Tag 


Customer Specified Line Voltage, frequency, 
and power cord 


Universal European line voltage, frequency, 
and power cord: 220 V, 50 Hz 


United Kingdom line voltage, frequency, and 
power cord: 240 V, 50 Hz 


Australian line voltage, frequency, and power 
cord: 240 V, 50 Hz 


North American line voltage, frequency, and 
power cord: 240 V, 60 Hz 


Swiss line voltage, frequency, and power cord: 
220 V, 50 Hz 


The terminal is compatible with the following Tektronix 


products: 


@ 4691 Color Graphics Copier 

@ 4612, 4632 and 4634 (Monochrome) Hard Copy Units 
@ 4662 and 4663 Interactive Digital Plotters 

@ 4925/4926 Option 25 Dual 5 %-Inch Flexible Disk Drive 
@ 4926 10MB Hard Disk Mass Storage Device 

@ 4643 Line Printer 
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INTRODUCTION 


ABOUT THE 4115B 


The following is a list of the main features of the 4115B 
Computer Display Terminal: 


@ Displays up to 256 colors simultaneously from a palette 
of over 16 million different colors. 


@ 1280x1024 pixel graphics resolution, supplemented by 
precise color convergence gives high quality graphics 
displays. 


@ An optional autoconvergence feature assures maximum 
color quality and integrity without operator adjustment. 


@ Drawing speed of up to 50,000 vectors per second, along 
with data transmission speed of up to 19,200 bits per 
second allow complex displays to be redrawn almost 
immediately. 


® The terminal features a 32-bit coordinate space that 
gives over 2 billion addressable points along each coor- 
dinate axis. 


@ Multiple bit planes give up to eight separate graphics 


surfaces. These surfaces can be displayed independently. 


@ A separate dialog plane is used to display your conversa- 
tions with the computer or terminal. The dialog text can 
be displayed “over” the graphics, allowing the graphics 
behind the text to show through. 


@ A low-profile keyboard is located on a sliding tray in the 
frame of the terminal for convenient, comfortable typing. 


@ An optional color copy interface allows color copies of 
screen displays on a TEKTRONIX 4691 Color Graphics 
Copier. With the peripheral interface option, the terminal 
can also make color copies on a TEKTRONIX 4662 or 
4663 digital plotter. 


@ Self Test diagnostic programs in terminal firmware check 
the terminal’s operation each time the terminal is turned 
on. If an error is detected, the terminal displays a light 
pattern on the indicator lamps or a message on the dis- 
play screen. These can be reported to your Tektronix 
service technician for quicker correction of the problem. 


The rest of this section describes the major characteristics 
of the display, the keyboard, and the pedestal. Section 2 
describes all the external controls and indicators on the 
terminal. 
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THE DISPLAY 


The display module (Figure 1-2) contains the circuitry for the 
display and the screen itself. The display brightness can be 
adjusted by the INTENSITY control. The DEGAUSS/CON- 
VERGE button allows you to demagnetize the display and 
restore the purity and accuracy of the color display when 
the display unit has been subjected to variations in mag- 
netic or electrical field intensity. See Section 2 for a descrip- 
tion of the display unit front and rear panel controls and 
connectors. 


THE GRAPHICS AREA 


Both graphics and text can be displayed on the terminal’s 
19-inch display screen. Using multiple bit planes the termi- 
nal can display up to eight separate graphics surfaces. Each 
surface has its own assignment of colors and can display its 
own set of graphics information. Surfaces can be displayed 
in various modes to allow later graphics to obsure earlier 
graphics, or to allow the earlier graphics to show through 
later graphics like layers of colored glass. 


DEGAUSS/CONVERGE 





INTENSITY 
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Figure 1-2. The 4115B Display. 
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Segments 


A graphics segment is a picture or a part of a picture that can 
be manipulated as a unit by terminal commands. 


The terminal stores segments locally, allowing a graphics 
application program to be more flexible and allowing a 
greater interaction with the terminal operator. Local storage 
of segments also reduces terminal/host communications 
needs and allows the terminal to handle some of the compu- 
tational and storage tasks for which the host would other- 
wise be responsible. Also, a picture stored in segments can 
be manipulated on the display with the terminal’s viewing 
keys. 


Appendix F illustrates some of the commands used to 
manipulate graphics segments. 


Multiple Views 


The screen can be divided into as many as 64 individual 
views, each with its own viewport, window, etc. You can 
manipulate the segments in each view can be manipulated 
locally with the viewing keys discussed in Section 2. 


Graphics Input 


Graphics Input (GIN) mode allows you to send graphic infor- 
mation to a host-resident program from the terminal, a plot- 
ter, or a graphic tablet (Option 13/14). Section 4 discusses 
GIN mode 


DIALOG BUFFER AND DIALOG AREA 


The dialog buffer is a part of terminal memory reserved for 
storing text — in particular, for your conversations with the 
host computer or with the terminal. Text in the dialog buffer 
is displayed in the dialog area — a portion of the screen that 
you define. The dialog area is assigned a separate “sur- 
face” in the terminal from the graphics surfaces. This allows 
the dialog text to be displayed without interfering with any 
graphics display. 

The dialog area can be turned on or off (made visible or 
invisible) without affecting its contents, allowing you to 
switch back and forth between graphics and text without 
losing either. 


The dialog area is discussed in more detail in Section 2. 
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Setup Mode 


In Setup mode you can enter English-like setup commands 
directly from the keyboard. These commands are used to 
prepare the terminal for communications with a host, 
describe and position the dialog area, specify what kinds of 
errors the terminal should report, control peripheral 
devices, and other terminal functions. 


You place the terminal in Setup mode by pressing the SET 
UP key at the top of the keyboard. The red light in the key 
goes on to indicate that Setup mode is active. To leave 
Setup mode, just press the SET UP Key again. 


Section 6 discusses all Setup commands in detail. 


The terminal “remembers” most setup command settings 
after it is turned off and then turned back on. This means 
that you don’t need to enter the same setup commands 
every time you use the terminal, unless you want to change 
some of the setup parameters. 


There is also a set of commands called escape sequences, so 
named because the first character is always the escape (&c) 
character. Escape sequence commands also can be 
entered in Setup mode and include all English-style setup 
command equivalents. Appendix C summarizes all escape 
sequence commands. 


Local Mode 


The LOCAL key initiates or terminates Local mode. When 
the terminal is in Local mode, it is as if it were not connected 
to a host computer. Data that would normally be sent to the 
host is interpreted as if it came from the host. Host input that 
comes to the terminal while it is in Local mode is stored ina 
queue and is executed when Local mode is terminated. If 
the dialog area is in use, text entered in Local mode 
appears in the dialog area. 


Local mode is discussed in Section 2. 


Error Reporting 


When the terminal detects an error condition, it is recorded 
in an internal error queue and can be displayed on the 
screen. There are four levels of errors. You can establish the 
error threshold, which determines which error messages 
are displayed on the terminal (see ERRORLEVEL in 
Section 6). 


Appendix A lists the terminal’s error messages. 
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THE PEDESTAL 


The display module rests on the pedestal (Figure 1-3). The 
pedestal contains the terminal’s internal logic, the key- 
board, and the flexible disk drives (optional). 


THE KEYBOARD 


The terminal keyboard (Figure 1-4) is described in detail in 
Section 2. Its features include: 


@ A light-weight, low-profile construction keyboard on a 
convenient slide-out tray. 


@ Pre-programmed command keys for commonly used 
features. 


Programmable function keys. 
Viewing keys to manipulate graphics segments. 


@ Thumbwheels to scroll the dialog area, control graphics 
input, and define a new view when the terminal is:in 
Framing mode. 


@ Indicator lights to inform you when the terminal is ina 
particular mode or transmitting or receiving data. 


FUNCTION INDICATOR 
KEYS LIGHTS 


COMMAND 
KEYS 


ASCII KEYS THE BREAK 
(TYPEWRITER-LIKE KEYS) 


Figure 1-4. The 4115B Keyboard 
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Figure 1-3. The 4115B Pedestal. 


COMMAND 
KEYS THUMBWHEELS 





VIEWING 
KEYS 
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The Viewing Keys 

The four viewing keys (Figure 1-5) allow you to modify the 
graphics on the screen easily and quickly. You can: 

@ Zoom in on asegment for a closer view. 

@ Pan across a segment to view part of it in greater detail. 
®@ Restore the original view. 


@ Restore the original aspect ratio for the viewport (if you 
changed it by zooming and panning). 


®@ Get an overview of the entire viewport (after you have 
zoomed or panned). 


@ Create a border around a viewport. 





You Can also select which viewport the viewing keys are 
active in. Figure 1-5. The Viewing Keys. 


The viewing keys are described in detail in Section 2. 
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' Section 2 


CONTROLS, INDICATORS AND KEYBOARD 


This section describes all external controls and indicators PEDESTAL (cont) WRITE PROTECT indicators 
on the terminal and the keyboard layout and special keys. . (Options 42, 43) 
Connectors on the rear panel are discussed briefly, Disk drive indicators 
although these will be of limited interest to most operators. MASTER RESET button 
(Options 42, 43) 
SELF TEST button 
KEYBOARD cable connector 
FRONT PANEL CONTROLS These are discussed in this section in a slightly different 
AND INDICATORS order. In addition, the keyboard contains several indicator 
lamps; these are discussed under Keyboard later in this 
Both the display unit and the pedestal contain front-panel section. 
controls, as follows: 
DISPLAY UNIT DEGAUSS/CONVERGE button POWER SWITCH 


INTENSITY control 
The POWER switch (Figure 2-1) controls AC power to the 
PEDESTAL POWER switch entire terminal (even though the display unit and pedestal 
WRITE PROTECT switches each has its own AC power cord — see Rear Panel Connec- 
SOpMOns 45, 5a) tors \ater in this section). 


POWER 
SWITCH 









Ss SAAR NRO 
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Figure 2-1. The POWER Switch. 
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CAUTION DISPLAY UNIT 
AIR VENTS 


Do not block the terminal’s air vents (Figure 2-2). If 
either the display unit vents or the pedestal vents 

are blocked, the terminal may overheat, causing 
damage to its circuitry. 





To turn the terminal on, push the POWER switch in until it 
clicks, then release it. A green indicator appears in the 
switch to indicate that the power is on. You should hear the 
ventilation fan inside the pedestal turn on. 


The Power-Up Sequence 


Each time you turn the terminal on, it automatically tests 
parts of its memory and circuitry. This is called the power-up 
sequence. \t takes from 15 to 60 seconds, depending on 
what options your terminal has. 


During the power-up sequence, the lights in the keyboard 
(Figure 2-3) go through the following sequence: 


@ All lights turn on. 
@ The CAPS LOCK light turns off. 
® ; 
All other lights turn off PEDESTAL 


@ The XMT and RCV lights flash once simultaneously. AIR VENTS 
(ON REAR) 

If the power-up sequence detects an error, the terminal bell 

rings one, two, or three times, depending on the severity of 

the problem. There may also be a message on the screen. If 

this occurs, see Appendix A. If the power-up sequence is 

successful, the cursor flashes in the upper-left corner of the 

screen. As soon as the cursor appears on the screen, the 

terminal is ready for use. If the dialog area is enabled (see 

DIALOG later in this section), the cursor appears on the 

first available line of the dialog area. 
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Figure 2-2. The Air Vents. 
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Power-Up Defaults 


Many elements of the operating environment can be altered 
under program control or by setup commands. The results 
of many of these changes are stored in setup memory and 
are remembered when the terminal is turned on. These 
power-up defaults are shown in Table 6-1. Setup commands 
and Setup mode are discussed in this section under the 
heading SET UP and in Section 6. 


Table 6-1 also indicates the factory default operating envi- 
ronment of the terminal. Factory default means the setting 
that the terminal has when it is shipped from the factory. If 
the parameters were altered by setup commands, the status 
of your terminal is different from what is shown shown in 
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Table 6-1. See the STATUS command in Section 6 for infor- 
mation on how to determine the status of your terminal. 


If the setup memory fails, the operating environment is reset 
to the factory default. If this has happened, you are 
informed by the message: 


SETUP DEFAULTS RESET 
during the power-up sequence (see Appendix B). 


At times, you may want to reset the default parameters 
yourself. For this procedure, see the heading Resetting 
Setup Memory in Appendix B. 





LIGHTS ACTIVE 
DURING 
POWER-UP SEQUENCE 
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Figure 2-3. Power-Up Indicator Lights. 
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MASTER RESET BUTTON Pressing the MASTER RESET button has the same effect 
on the circuitry as turning the terminal off and back on: 
NOTE @ Macros are deleted from programmed keys. 
Do not press the MASTER RESET button if there @ Graphics data is deleted from the terminal’s memory. 


is important information stored in the terminal's 
memory. Resetting the terminal deletes all graphics 
data as well as macros that have been programmed @ The screen is erased. 
into keys. 


@ The terminal runs its power-up sequence. 


You can save information before resetting the terminal by 


making a hardcopy of the screen (the HARD COPY key is 
Use the MASTER RESET button (Figure 2-4) when you explained later in this section.) If your terminal has the flexi- 


want to return the terminal to its power-up condition. ble disk drives (Option 42 or 43), you can copy data to a disk 
or to a host file (see Section 3). 








: SELF MASTER 
| TEST RESET 
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Figure 2-4. The MASTER RESET and SELF TEST Buttons. 
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SELF TEST BUTTON 


An extensive test of the terminal’s operating conditions is 
initiated by the SELF TEST button (Figure 2-4). Self-test 
thoroughly tests the terminal and allows a service techni- 
cian to make any necessary adjustments. Self-test is more 
fully explained in Appendix B. 


The SELF TEST button can also be used to reset all 
terminal parameters to their factory default values. See 
Appendix B for details. 


When you press the MASTER RESET button in conjunction 
with the SELF TEST button, a more extensive self-testing 
procedure is initiated (see Appendix B). 


WRITE PROTECT SWITCH 
AND INDICATOR(S) 


The terminal can have one or two flexible disk drives 
(Options 42 or 43). These are located in the pedestal 
between the display and keyboard. The WRITE PROTECT 
switch for each disk drive is located in the panel between 
the disk drives (Figure 2-5). 


If there is no disk in the drive, the red WRITE PROTECT 
light is always on. It cannot be turned off. 


When a disk is in the drive and you turn on the WRITE 
PROTECT switch, the disk in the drive is write-protected. 
When a disk is write-protected, the terminal will not write 
data on it. This prevents you from writing over (and thus 
destroying) data already on a disk. 


Press the switch down to unprotect the disk (and turn off the 
light). You can also protect a disk by uncovering the write- 
protect notch in the disk itself (see Section 3). 


NOTE 


Individual files on a disk can also be write-pro- 
tected. See the PROTECT command description in 
Section 6. 
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DISK DRIVE INDICATOR 


When the red disk drive indicator (Figure 2-5) is on, the 
drive is either reading from or writing to the disk. When the 
light is off, the drive is not operating. The use of the disk 
drives is explained in Section 3. 


Do not open the disk drive’s door when the drive is 
operating (the red light is on). To do so interrupts 
the READ or WRITE in progress. Wait until the 
READ or WRITE is finished to remove or change 
disks. 


WRITE PROTECT 
SWITCH 


DISK DRIVE 
INDICATOR 


WRITE PROTECT 
INDICATOR 





Figure 2-5. The WRITE PROTECT Switch, WRITE PROTECT 
Indicator, and Disk Drive Indicator. 


2-5 


CONTROLS, INDICATORS AND KEYBOARD 


KEYBOARD CONNECTOR 


The terminal features a detached keyboard that connects to 
the pedestal by a coiled cable. This cable plugs into the 
KEYBOARD connector on the front of the pedestal unit 
(Figure 2-6). Plug in the cable, then secure it with the two 
wire clips attached to the sides of the connector. 


WIRE CLIPS 


KEYBOARD 
CONNECTOR 


DEGAUSS/CONVERGE BUTTON 


When the display unit is subjected to variations in electrical 
or magnetic field intensity, the purity and accuracy of color 
display may be degraded. If this occurs, press and release 
the DEGAUSS/CONVERGE button (Figure 2-7). Pressing 
the button erases the screen momentarily; when you 
release the button, the display is restored and the quality of 
color display should be improved. 


INTENSITY CONTROL 


The INTENSITY control is used to adjust the intensity — or 
brightness — of the display (Figure 2-7). Turn the control 
clockwise to brighten the display; turn it counterclockwise to 
dim the display. 
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Figure 2-6. The KEYBOARD Connector. 
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Figure 2-7. The Display Controls. 
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| DEGAUSS 
| BUTTON 
DEGAUSS 
CONVERGE 








INTENSITY 
CONTROL 
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THE KEYBOARD 


The keyboard is shown in Figure 2-8. 


The keys can be grouped into six categories: 
@ ASCII Keys 

@ The Thumbwheels 

@ The Break Key 

@ Command Keys 

@® Function Keys 


@ Viewing Keys 


INDICATOR LIGHTS 


The keyboard also includes four indicator lights (Figure 2-9): 


the KYBD LOCK light, the PAGE FULL light, the XMT light, 
and the RCV light. 


KYBD LOCK 


When the KYBD LOCK light (Figure 2-9) is on, the keyboard 
is locked. A program may lock the keyboard to prevent you 
from typing anything at a time when doing so would inter- 
fere with data being sent from the host. 


When the keyboard is locked, you can still press the keys, 

but data is not transmitted, echoed, or queued. When you 

press any key (except Break or CANCEL) the terminal’s bell 
rings to remind you that data is not being input. 


The program should unlock the keyboard when the trans- 
mission of the critical data is complete. 


You can also unlock the keyboard by pressing the MASTER 
RESET button or the CANCEL or Break keys. However, you 
should use MASTER RESET, CANCEL, and Break with 
caution. The MASTER RESET button deletes information in 
the terminal’s memory, including any text or graphics cur- 
rently stored there. The CANCEL key terminates several 
terminal functions besides the locked keyboard. The Break 
key can have undesirable effects on some host computers. 


For further details, see the explanations of MASTER 
RESET, Break, and CANCEL in this section and the 
LOCKKEYBOARD command in Section 6. 


PAGE FULL 


When the PAGE FULL light (Figure 2-9) is on, the terminal is 
in the “page-full” condition. It will not display any more text 
or graphics until the page-full condition is cleared by: 


@ Pressing the HARD COPY key, which makes a copy of 
the page, clears the screen, and allows another page to 
be displayed. 


@ Pressing the Page key, which clears the screen and 
allows another page to be displayed. 


@ Pressing any key except Shift, which eliminates the 
page-full condition and allows the display to write new 
data over existing data. 


The terminal can also be set to make a hard copy of the 
screen, erase the screen, and continue automatically when 
it reaches a page-full condition. See the PAGEFULL setup 
command in Section 6 for details. 


XMT 


The abbreviation XMT stands for transmit. The transmit 
light (Figure 2-9) is on when data is being sent from the 
terminal to the host computer. 


RCV 


The abbreviation RCV stands for receive. The receive light 
(Figure 2-9) is on when data is being received by the termi- 
nal from the host computer. 


THE THUMBWHEELS 


The thumbwheels (Figure 2-10) have three uses: 
@ To scroll the dialog area. 


@ To move the GIN cursor. This cursor is used to locate a 
point on the screen to be sent to a graphics program 
being run from a host computer. 


@ To manipulate the framing box when the terminal is in 
Framing mode. 


The dialog area is discussed later in this section, under the 
heading DIALOG. Using the thumbwheels when the termi- 
nal is in Graphics Input (GIN) mode is discussed in 

Section 4. Examples of how to use the thumbwheels are 
contained in Appendix F or in the 47/5B Introduction 
Brochure. 
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FUNCTION INDICATOR COMMAND 
KEYS LIGHTS KEYS THUMBWHEELS 





COMMAND 
KEYS 
ASCII KEYS THE BREAK VIEWING 
(TYPEWRITER-LIKE KEYS) KEY KEYS 
: 4665-4 
Figure 2-8. The Keyboard. 
KEYBOARD PAGE 
LOCK FULL XMT RCV 





Figure 2-9. The Keyboard Indicator Lights. 





Figure 2-10. The Thumbwheels. 
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THE ASCII SECTION 


The main keyboard section consists of the ASCII keys (see 
Figure 2-8), so called because each one generates one of 
the ASCII characters (see the ASCII Code Chart appendix). 
The ASCII keys are divided into alphanumeric keys and 
control keys. These are discussed under the following 
headings. 


Alphanumeric Keys 


NOTE 


Four optional keyboards are available for interna- 
tional use (see Appendix E). Descriptions in this 
section apply only to the standard keyboard. 


The alphanumeric section of the keyboard looks like a type- 

writer keyboard (Figure 2-11). The alphanumeric keys trans- 
mit the characters shown on their keycaps to the terminal or 
to a host computer. These are also called printing characters 
since they have symbolic representations which are printed, 
or echoed, on the screen or printed by a line printer. 


The space is a printing character. 


If the terminal’s Autorepeat feature is enabled and you hold 
down an alphanumeric key for more than half a second, the 
character repeats at a rate of 10 times per second until you 
release the key or press another key. 


When the terminal is in Local or Setup mode and you press 
an alphanumeric key, it is displayed (echoed) on the screen. 
Whether the characters are echoed when you are logged 
onto a host computer depends on whether the terminal or 
the host is providing the echo. See the ECHO command in 
Section 6 for details. 


The character normally transmitted by an alphanumeric key 
can be replaced by a macro (a character or character string 
programmed into the key). This is explained later in this 
section under the heading Function Keys. 


Control Keys 


A control character is a character that has special meaning 
for the terminal or host computer. The terminal can send 
and receive all standard control characters. When some 
control characters are transmitted, you cannot see their 
result on the display. Others, however, cause visible 
changes in the display. For example, the carriage return 
control character causes the cursor to return to the left 
margin; the line feed control character causes the cursor to 
move down one line. 
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Figure 2-11. The Alphanumeric Keys. 
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There are six control characters that have their own keys 
(Figure 2-12): 


@ Rub Out (delete) 

@ Line Feed (line feed) 

@ Back Space (backspace) 

@ Rtn (carriage return) 

@ Esc (escape) 

@ Tab (horizontal tab) 

The Ctrl and Shift keys are included in the following descrip- 
tion of the control keys because they are used to specify 


control characters that are not represented on the 
keyboard. 


The Rub Out Key. The Rub Out key sends the rub out (or 
delete) character. 


Rub Out is the factory default character delete key in Setup 
mode. See the explanation of the EDITCHARS command in 
Section 6. 
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The Line Feed Key. This key sends the /ine feed character, 
which causes the cursor to move down to the next line with- 
out returning it to the left margin. If the cursor is at the bot- 
tom of the screen and is not in the dialog area, a line feed 
moves it to the top of the screen one margin to the right of 
the current margin. When the cursor is at the bottom of the 
last column, a line feed either causes it to move to the top of 
the first column or causes a page-full condition (see | 
PAGEFULL in Section 6). 


You can use the setup command LFCR to cause a line feed 
received from the host computer (or from the terminal when 
it is in Local mode) to cause the terminal to generate a line 
feed and carriage return (see Section 6). 


The Back Space Key. The Back Space key sends the back- 
space character, which moves the cursor one character 
position to the left. 


The following explanation applies when the terminal is not 
in Setup mode or connected to a host. If the cursor is in the 
dialog area and is already at the left margin when you press 
the Back Space key, the cursor does not move. If the cursor 
is not in the dialog area and is already at the left margin 
when you press the Back Space key, there is no effect. 


Rub 
Out 


Line 
Feed 


Return 
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Figure 2-12. The Control Keys. 
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The Rtn Key. The Rtn key sends the carriage return control 
character, which returns the cursor to the left margin of the 
current line. 


Some host computers automatically include a line feed 
when they echo or send the return character, so that pres- 
sing the Rtn key moves the cursor down one line and to the 
left margin. If your host does not, you can use the setup 
command CRLF (explained in Section 6) to cause the termi- 
nal to include a line feed with the return character. 


In Setup mode, the terminal automatically provides a car- 
riage return and line feed when you press the Rtn key. 


The Esc Key. When you press Esc, the terminal sends 
the escape character when it is communicating with a host 
computer. 


The escape is the first character in a special command 
sequence called an escape sequence. Appendix C lists the 
escape sequence commands. For detailed explanations of 
all escape sequence commands, see the 4/10 Series Host 
Programmers Reference Manual. 


The Tab Key. The Tab key transmits the horizontal tab char- 
acter. 

Depending on how your host treats this character, it can 
cause the cursor to move a certain number of spaces to the 


right. 


When the terminal is in Local mode, the cursor moves one 
character to the right each time you press the Tab key. 
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The Ctri Key. Some control characters are used often and 
have their own keys, such as Rtn and Line Feed. Others, 
however, do not. You can transmit any control character by 
holding down the Ctrl key while you press another key. 


For example, press Ctrl and the G key (Ctrl-G) at the same 
time to send the ASCIl Bel character, which causes the 
terminal bell to sound; Ctril-M sends a carriage return char- 
acter, causing the cursor to return to the left margin; Ctrl-J 
sends the line feed character, causing the cursor to go down 
one line. 


The Shift Key. Most keys have two meanings: an unshifted 
meaning and a shifted meaning. 


When you press the key labeled W while holding down the 
Shift key, the terminal sends the uppercase character W; 
pressing the same key without the Shift (if the Caps Lock 
key light is not on) sends the lowercase letter w. Some keys 
are labeled with two non-alphabetic characters, one above 
the other. For example, press the key labeled 5 to transmit a 
5; press the same key and the Shift key to send the percent 
(%) character. 


Programmable function keys and the non-programmable 
command keys can also have shifted and unshifted mean- 
ings, as explained under the headings Command Keys later 
in this section. 


The Shift key is also used at the same time as the Ctrl key to 
send some control characters. 


4115B OPERATORS 


The Break Key. The Break key (Figure 2-13) can be used to 
interrupt communications from some host computers to the 
terminal. It does not actually send a character to the host; 
instead it alters the state of the communications line so that 
the computer stops sending information to the terminal or 
stops the execution of a program. 


Before using the Break key, or the BREAKTIME 

~ command, find out how the host computer handles 
the interrupt. An unexpected Break signal could 
cause program failure or equipment damage. 
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The length of time that the interrupt lasts is important to 
some host computers. You can use the setup command 
BREAKTIME to specify the length of the interrupt sent by 
the terminal to the host, or to disable the Break key, as 
explained in Section 5. 


It is also important to know that various host computers 
react differently when they receive the Break. One host 
might stop the execution of a program while another might 
log you off and break the communications link to the termi- 
nal. Therefore, before using the Break key or BREAKTIME 
command, you should find out how the interrupt is handled 
by your host. 


Pressing the Break key also unlocks the keyboard (see Kbd 
Lock earlier in this section). 





BREAK 
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Figure 2-13. The Break Key. 
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COMMAND KEYS 


There are six command keys (Figure 2-14) that perform 
special functions or put the terminal into a particular mode 
of operation. These keys cannot be programmed to do any 
other function. Their purpose is to allow you to easily access 
frequently used terminal features. 


The eight command keys are: 
@ Page 

@® Caps Lock 

@ SETUP 

@ DIALOG 

@ CLEAR 

@ LOCAL 

@ CANCEL 

@ COPY 


Page 
When you press the Page key, the following items are 
erased: 


@ Graphics in the current view that are not part of a graph- 
ics segment (a graphics segment is a picture or part of a 
picture that can be manipulated by terminal commands). 


@ Text that is not part of a graphics segment and not in the 
dialog area. 

The following are erased momentarily and then redrawn 

when you press the Page key: 

@ Segments visible in the current view. 

@ The framing box. 


@ Border around a viewport. 


A segment is permanently erased by being deleted from the 
terminal's memory. A segment can also be made invisible 
(not erased from the terminal’s memory, but not visible on 
the screen). After a segment has been deleted, you may still 
need to press Page to erase its image from the screen, 
depending upon how the terminal’s FIXUP parameter is set 
(see Section 6). 





CAPS 
LOCK 
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Figure 2-14. The Command Keys. 
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If the dialog area is not enabled, the following actions occur 
when you press Page: 


@ The cursor returns to the home position (the upper-left 
corner of the screen). 


@ The terminal goes into alpha mode (that is, it interprets 
all incoming data as alphanumeric data, not graphic 
data). 


@ 4010 Series Graphics Input (GIN) mode is terminated. 


Because of these actions, it is generally best not to press 
Page while a program is running with the dialog area dis- 
abled. (These actions do not take place if the dialog area is 
enabled.) 


Caps Lock 


The Caps Lock key is similar to the Shift Lock key ona 
typewriter. 


When you press Caps Lock, the red light in the key comes 
on and alphabetic characters are transmitted in upper case. 
The Caps Lock does not cause the uppercase version of 
numeric, command, or function keys to be transmitted. 


Especially useful on host systems that do not accept lower- 
case alphabetic characters, Caps Lock allows you to easily | 
send only uppercase alphabetic characters to the host, but 
still allows you to conveniently send numeric characters 
rather than special symbols. 


SET UP 


When you press the SET UP key, the light in the key turns 
on and the terminal enters Setup mode. (If the dialog area is 
enabled, the light in the DIALOG key also turns on. See the 
discussion of the dialog area later in this section.) With the 
terminal in Setup mode, you can enter English-like com- 
mands (called setup commands) directly to the terminal. You 
can also enter escape sequence commands that would 
normally be sent from the host. 


Setup commands allow you to establish the terminal’s oper- 
ating environment and to use peripherals attached to the 
terminal. Setup commands are used for such things as 
establishing communication rates, inquiring about the ter- 
minal’s status, determining what kinds of errors the terminal 
should display, and programming special meanings 
(macros) into keys. 
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The results of many setup commands are stored in setup 
memory. Specifications stored in setup memory are remem- 
bered even if the terminal is turned off or unplugged. 


Section 6 describes Setup mode and all of the setup 
commands. 


DIALOG 


Part of the screen can be used to display your conversa- 
tions (dialog) with the terminal and the host computer. This 
portion of the screen is called the dialog area. The DIALOG 
key can be used to make the dialog area visible or invisible. 
However, the dialog area interacts with other command 
settings. A more complete discussion of the dialog area is 
therefore given here. 


The text that can be written in the dialog area includes: 
@ The terminal’s error messages. 
@ Commands entered in Setup mode. 


@ Text entered in Local mode (most commands entered in 
Local mode are not echoed on the screen). 


@ Non-graphics (alpha) text included in a graphics 
program. 


@ Host-generated messages, such as prompts, warnings, 
and error messages. 


@ Normal terminal/host communications. 


See the explanation of the CLEAR key later in this section 
for details on how to page text from the dialog area. 


Enabling the Dialog Area. Text is directed to the dialog area 
when the dialog area is enabled. When the dialog area is 
disabled, text is displayed with graphics. The DAENABLE 
command is used to enable or disable the dialog area. As 
illustrated in Figure 2-15, if the dialog area is enabled, the 
text is directed to the dialog buffer. The dialog buffer can be 
thought of as a scroll, part of which is displayed at a speci- 
fied screen location. 


Whether the dialog area is enabled is stored in setup mem- 
ory. For example, if you enable the dialog area and turn the 
terminal off, it will be enabled the next time you turn the 
terminal on. 
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4010 Compatibility. The terminal can distinguish between 
text that is part of the graphics (graphics text) from text that 
is not part of graphics (alpha text). Graphics text, such as 
titles and labels, is displayed with the graphics. Alpha text is 
sent to the dialog area. Programs written for 4010 Series 
and 4020 Series Tektronix terminals can also be run on this 
terminal, but special consideration must be made for text 
since those terminals do not have a dialog area. 


For example, you can run a program that was originally 
written for a 4010 terminal. If the program includes text 
(such as a title or labels) and the dialog area is active, the 
terminal will strip the title and labels out of the picture and 
display the text in the dialog area. 


When the dialog area is disabled, the terminal does not 
intercept text and display it in the dialog area. The DAEN- 
ABLE command allows a 4010-style program with text to 
execute on this terminal just as on a 4010 Series terminal. 


Dialog Area Visibility. Even if the dialog area is enabled, it 
must also be made visible so you can see the text that is 
sent to it. If the dialog area is enabled but not visible, dialog 
is written in the dialog area but neither the text nor the cur- 
sor is visible. 


The DIALOG key is used to make the dialog area visible or 
not visible. When the red light in the key is off, the dialog 
area is not visible. (You can also use a setup command 
called DAVIS to make the area visible or not visible — 

see Section 6.) 


If the dialog area is enabled when you turn on the terminal, 
the light in the DIALOG key turns on, the dialog area is 
visible, and the cursor is displayed in the dialog area. If the 
dialog area is not enabled when you turn on the terminal, 
the dialog area is not visible and the cursor appears in the 
upper-left corner of the screen. 


Dialog Buffer. Text sent to the dialog area is stored ina 
special area of terminal memory called the dialog buffer. 
The DABUFFER command allocates a certain amount of 
the terminal’s memory for the dialog buffer. The factory 
default is 34 lines. 


When the dialog buffer is full, the first line is deleted so 
another line of dialog can be added to the end. 


The maximum length of each line is specified by the 
DACHARS command. 


Visible Portion of the Dialog Area. It is not usually neces- 
sary or desirable to have the entire dialog buffer visible. The 
DALINES setup command specifies the number of visible 
lines in the dialog buffer. The factory default is five lines. 


When the dialog area is visible, you can use the top 
thumbwheel (Figure 2-10) to move (scroll) through the dia- 
log area to observe its entire contents. As you scroll, you are 
moving the window, shown in Figure 2-15, so that different 
lines in the dialog area are visible. The window is that por- 
tion of the scroll that can be seen in the dialog area. The 
cursor stays on the line below the last line of dialog. This 
assures you that information sent to the dialog area while 
you are examining it does not overwrite information that is 
already there. 





Figure 2-15. Enabling the Dialog Area. 
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Line Length. The maximum length of each line in the dialog 
area is specified by the DACHARS setup command. The 
factory default is 80. 


Dialog Area Writing Mode. The DAMODE setup command 
specifies whether a character in the dialog area is overwrit- 
ten or erased when you backspace the cursor, and whether 
a new space or underscore character will replace a charac- 
ter already displayed at that location. The factory default is 
Replace. Replace means that when the dialog area is 
enabled and visible and you backspace over a character, it 
is erased. The other setting is Overstrike. Overstrike means 
that when the dialog area is enabled and visible, backspac- 
ing over a character leaves the character unaltered. Enter- 
ing a space or underscore character leaves the old 
character at that location. 


A special character delete key is used to backspace in Setup 
mode. See the EDITCHARS command in Section 6. 


Dialog Area Position. You can position the dialog area 
anywhere on the screen. The DAPOSITION command 
specifies the location of the lower-left corner of the dialog 
area. The terminal positions the last visible line of the dialog 
area as close as possible to that location. 


For example, the factory default position is the lower-left 
corner of the screen (0,0). This means that the dialog area is 
located so that the last visible line (the fifth line, by factory 
default) begins at the lower-left corner of the screen. 
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CLEAR 


To erase the dialog area, press the SHIFT and DIALOG/ 
CLEAR keys at the same time. This clears all text from the 
dialog buffer. The result is that the dialog area is erased. It 
does not erase any graphics on the screen or affect whether 
or not the dialog area is visible. 


LOCAL 


When you press LOCAL, the red light in the key turns on 
and the terminal enters Local mode. If the terminal is 
already in Local mode, pressing the Keys turns the light off 
and terminates Local mode. 


In Local mode, communications to and from the host com- 
puter are temporarily suspended. Everything typed at the 
keyboard is interpreted by the terminal as if it came from the 
host. Information or data received from the computer is not 
processed; it is put into a queue and processed when you 
exit from Local mode. 


Figure 2-16 illustrates the flow of communications. Notice 
that when the terminal is in Local mode, data transmission 
is routed back to the terminal instead of being sent to the 
host. 


In Local mode, you can enter commands (escape 
sequences) from the keyboard in the same format that a 
host uses and the terminal executes them as if they came 
from the host. 


If both Setup and Local modes are active, Setup takes 
priority. 


HOST 


COMPUTER 


Figure 2-16. Communications in Flow in Local Mode. 
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CANCEL 


Press the Shift and LOCAL keys at the same time to initiate 
a CANCEL operation. ACANCEL operation: 


@® Halts all disk, host, and 3PPI file copy operations except 
spooling (Section 6). 


@ Terminates segment operations. 

@ Cancels Bypass mode (BYPASSCANCEL in Section 6). 
@ Terminates Graphics Input (GIN) mode (Section 4). 

@ Unlocks the keyboard (LOCKKEY BOARD in Section 6). 


If a file transfer is cancelled (COPY in Section 6), the file is 
closed. All information in that file operation up to the time of 
the CANCEL command is preserved. 


HARD COPY 


The HARD COPY key is used to make hard copies of the 
screen display when a compatible copier is attached to the 
terminal. To ensure good quality copies, allow the copier to 
warm up for a few minutes before copies are made. 


The exact length of time it takes to make a hard copy of the 
screen depends on the type of hard copy unit, but a typical 
time is about ten seconds. Data sent to the terminal during a 
hard copy operation is stored in the terminal’s input queue 
until the copy is finished. Data transfer operations and other 
non-display terminal functions continue undisturbed during 
a hard copy operation. 


The standard terminal can make black and white copies of 
the screen on a TEKTRONIX 4612, 4632, or 4634 Hard 
Copy Unit. The 4612 makes black and white copies only. 
The 4632 and 4634 make gray-scale copies with each color 
mapped to a particular gray level. (See the CMAP command 
in Section 6 for details on this mapping.) See Section 3 for 
details. 


Pressing the HARD COPY button copies the display just as 
it appears on the screen (with black copying to black, etc.). 
Pressing Shift- HARD COPY (hold down the Shift key while 
you press the HARD COPY button) produces a reverse video 
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image, with black copying to white and vice versa. This 
gives dark letters on white copy paper, similar to typewriter 
copy. The mapping of colors to gray levels is unaffected. 


You can also copy the screen by pressing the COPY button 
on the hard copy unit. 


With Option 09, the 4691 Color Graphics Copier Interface 
installed and a 4691 copier attached to the terminal, you 
can make color hard copies of the screen by pressing the 
HARD COPY key. See the HC command descriptions in 
Section 6 (HCCOPIES, HCINTERFACE, etc.) and Section 3 
for details on making color hard copies. 


FUNCTION KEYS 


Most of the terminal’s keys are programmable. This means 
that you can define the character or character string that is 
transmitted when you press a particular key. The character 
string or individual character assigned to a key is called a 
macro. 


The eight programmable function keys (Figure 2-17) trans- 
mit nothing unless they are programmed. The alphanumeric 
and control keys have characters assigned to them, but 
they can be assigned a macro instead. 


Most keys can have two macros (shifted and unshifted). 
Keys that do not have a shifted version can have just one 
macro. A few keys are reserved for specific commands and 
cannot be programmed. Figure 2-18 shows the keys that 
are not programmable and keys that have no shifted 
version. 


The DEFINE setup command (see Section 6) is used to 
program a macro into a key. When you press a key that has 
a macro programmez into it, the key is expanded to mean 
that macro. 


When the terminal is reset or turned off, macros are deleted 
from the terminal’s memory. The DEFINE command can 
also be used to delete a macro and return a key to its origi- 
nal meaning. 
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PROGRAMMABLE 
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Figure 2-17. Programmable Function Keys. 
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Figure 2-18. Non-Programmable Keys. 
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VIEWING KEYS 


The terminal’s four viewing keys (Figure 2-19) allow you to 
examine a graphics display stored in segments in more 
detail. 


The PAN and ZOOM keys put the terminal into Framing 
mode. There are several additional functions, as indicated 
by the labels on the other viewing keys: VIEW, OVERVIEW, 
NORMAL, NEXT VIEW, RESTORE, and BORDER. 


The terminal’s display can be divided into as many as 64 
separate views. When there is more than one view, graph- 
ics actions (Such as Graphics Input and Framing mode) take 
place in the view that is currently active. The current view 
can be selected by program control or by pressing the termi- 
nal’s NEXT VIEW key. 


NOTE 


The viewing keys are disabled automatically in 
Setup mode. If the bell rings when you press any of 
the viewing keys, they have been disabled by the 
terminal's lock-viewing-keys command. To unlock 
the viewing keys, put the terminal into Setup mode 
and enter the following escape sequence command: 


<EC>RJ 0°R 


Escape sequence commands are explained in detail 
in the 4110 Series Command Reference Manual, 
and listed in Appendix C of this manual. 


Appendix F has an example of how to use the viewing keys. 
To better understand the function of all the keys, do the 
examples in Appendix F. 





Figure 2-19. The Viewing Keys. 
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Framing Mode 


When you press the ZOOM or PAN keys, the terminal enters 
Framing mode. In Framing mode, a framing box appears at 
the edges of the currently active viewport. You can change 
the location or shape of the framing box with the thumb- 
wheels. The box frames that portion of the view you want to 
see in more detail. 


The terminal’s screen resolution is 4096 x 3276 pixels 

(a 5:4 aspect ratio). However, the terminal’s internal coordi- 
nate space allows coordinates in the range + 2,147,000,000 
(approximately). This means that a graphics display can be 
represented internally with much greater precision than it 
can be displayed on the screen. It also means that you can 
zoom in on asmall portion of a display without losing sharp- 
ness or detail of the display. 


You can use the ZOOM key to view a smaller portion of the 
picture in more detail, and the PAN key to move the framing 
box across or up and down the current view. These keys are 
discussed in detail under the following headings. 


VIEW 


The VIEW key is used to update the view defined by the 
framing box that was formed by the PAN and ZOOM keys. 
When you have positioned the framing box outline to where 
you want it, press the VIEW key to update the display. The 
viewport is erased and the portion of the window that was 
within the framing box is displayed in the new viewport. The 
framing box again appears at the edge of the viewport. 


If you press Ctrl and VIEW at the same time, the view 
described by the framing box is displayed in the viewport 
with the previous view. However, the framing box remains 
active in the current viewport. 


For example, you might have two viewports defined on the 
screen, the larger of the two containing a picture. You can 
zoom into a small portion of the picture and press Ctrl-VIEW 
keys. The specified detailed view is displayed in the smaller 
viewport. This provides a detailed view as specified, but 
also leaves an overview of the larger picture visible. The 
framing box continues to be active in the current (larger) 
viewport. 
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ZOOM and PAN 


Pressing either the ZOOM or PAN keys makes that function 
active. The light in the key turns on to indicate that you are 
in Framing mode with the pan or zoom function selected. 
When the zoom function is active, the lower-left and upper- 
right corners of a rectangle appear in the framing box. The 
framing box represents the proposed new view (window). 


If you press ZOOM and rotate the top thumbwheel up and 
the bottom thumbwheel to the right, the height and width of 
the framing box increases (zooms out). If you rotate the 
thumbwheels in the opposite direction, the height and width 
of the framing box decreases (zooms in). In both cases, the 
framing box maintains its current aspect ratio. 


You can zoom in to 1/16th the size of the current window, or 
pan to the edge of the terminal space. If you want to zoom in 
more than that, press the VIEW key and then zoom in on 
that view. 


If you press the PAN key, the framing box is replaced by a 
crosshair. The thumbwheels move the box right, left, up, or 
down, in the current view. 


You can pan until the edge of the framing box reaches the 
edge of the terminal space (4096 x 4096) or until only Vs of 
the framing box is still in the current view, whichever hap- 
pens first. lf you have not reached the edge of the viewport 
and you want to pan more, press the VIEW key to update 
the current view and pan across that view until you have the 
view you want. 


You can zoom in on a view until it is about eight times its 
current size. If you want to zoom out more, press the VIEW 
key to update the viewport and then zoom out on that view. 


Terminate the pan or zoom function by exiting from Framing 
mode or by making the opposite function (pan or zoom) 
active. Exit from Framing mode by pressing the ZOOM key 
when the ZOOM key light is on. Press the PAN key to exit 
from the Framing mode when the PAN key light is on. The 
light in the key turns off as Framing mode is terminated. 


You can use both the zoom and pan functions before you 


update a view. For example, you could press the ZOOM key 


and zoom in, then press ZOOM again, and so on until you 
have the framing box located correctly. Then press the 
VIEW key. 


Panning and zooming occur in the currently active viewport. 


To pan or zoom in another viewport, use the NEXT VIEW 
key, as explained later in this section. 
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To Change the Aspect Ratio. While you are in ZOOM, 
press the Ctrl key and rotate a thumbwheel. This alters the 
aspect ratio of the framing box. Press Ctrl while you rotate 
the top thumbwheel to change the height of the box without 
affecting its width.Press Ctrl while you rotate the bottom 
thumbwheel to change the width of the framing box without 
affecting its height. To restore the original aspect ratio, 
press NORMAL. 


See the explanation of the RESTORE key for information on 
restoring a previous view. 


Vernier Action. If you press the Shift key while you rotate 
the thumbwheels, the box or crosshair changes more 
slowly, which allows you to more precisely position the win- 
dow. This is called vernier action. Press the Shift and Ctrl 
keys to use the vernier while rotating the thumbwheels to 
change the aspect ratio. 


OVERVIEW 


When you press the OVERVIEW key (Shift and PAN keys at 
the same time) the entire amount of terminal space normally 
displayed, as set by the host program, is made visible. If the 
pan or zoom function is active, it remains active and the 
framing box is visible. 


If you press the Ctrl and OVERVIEW keys (Ctrl-Shift-PAN) at 
the same time, the entire terminal space is displayed. 
(Notice that this changes the aspect ratio from its normal 5:4 
to a 1:1 ratio.) If the pan or zoom function is active, it 
remains active and the framing box is still visible (in a 1:1 or 
5:4 ratio). To restore the normal view and aspect ratio, press 
the OVERVIEW key again. 


NORMAL 


As mentioned earlier, you can change the aspect ratio of the 
framing box by pressing the Ctrl key while rotating a 
thumbwheel. 


If you then press the VIEW key, the view is updated with the 
same aspect ratio as the framing box. To cause the framing 
box to return to its normal (5:4) aspect ratio, press the NOR- 
MAL key (Shift and ZOOM keys at the same time). 
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NEXT VIEW 


When the display contains more than one viewport, the 
terminal internally identifies each viewport with an integer 
value. You can make the view with the next larger identifier 
active by pressing the NEXT VIEW key. 


You can make the view with the next smaller identifier active 
by pressing Ctrl the same time as the NEXT VIEW key. 


When a viewport becomes visible, a border around that 
viewport blinks once to indicate that it is active. You can 
then use the Framing mode and viewing key functions in 
that viewport. 


RESTORE 


The terminal remembers the last three views for each view- 
port. To restore the most recent view, press the RESTORE 
key. To restore the second most recent view, press 
RESTORE again. Press it a third time to restore the third 
most recent view. 


If you press RESTORE a fourth time, the terminal restores 
the view as it was before you altered it with a viewing func- 
tion. This original version of the view is not replaced when 
you press the VIEW key, as the three most recent views are. 
This means that you are always able to return to its original 
condition. 


If you press RESTORE a fifth time, you see the most recent 
view again. If you press it a sixth time, you see the second 
most recent view, and so on. 


You can immediately restore the original view (as it was 
before you altered it with a viewing function) by pressing 
Ctrland RESTORE at the same time. 


Since the three most recent views are saved, this list of 
views changes every time you press the VIEW key. 
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For example, when you press the VIEW key: 
® The third most recent view is deleted. 


@ The second most recent view becomes the third most 
recent. 


@ The most recent view becomes the second most recent. 
® The current view becomes the most recent. 


@ Thecontents of the framing box becomes the current 
view. 


BORDER 


You can cause the terminal to draw a border around the 
current viewport by pressing the BORDER key. If that view- 
port already has a border, pressing the key deletes the 
border. 


REAR PANEL AND CONNECTORS 


Connectors are located on both the display unit rear panel 
and the pedestal rear panel. All connectors are shown in 
Figure 2-20. If your terminal does not have the cables 
installed, check with a qualified person concerning proper 
cabling and installation. 


NOTE 


Figure 2-20 shows a typical arrangement of stanad- 
ard and optional connectors on the pedestal rear 
panel. The number and location of panels depends 
on the options installed. 
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DISPLAY UNIT CONNECTORS ® Mains fuse. This is the primary fuse for the display unit. 
Note that the display unit and the pedestal have separate 
The following are located on the rear of the display unit. fuses. SEE CAUTION! To remove a bad fuse, unscrew 
@ RED, GREEN, BLUE connectors. These accept color the cover on the fuse holder with a flat-blade screwdriver; 
signals from the pedestal (via BNC cables) and route the fuse pops out when the cover is removed. 


them to the proper portion of the display unit electronics. 


@ Display control connector. This accepts control signals 
from the pedestal and routes them to the proper portion 
of the display unit. The control cable plugs into this con- 


nector and is secured with the two wire clips attached to Ifa fuse burns out, it may indicate a serious fault in 


the connector. the terminal circuitry or in the AC power source. 
@ AC power connector. This accepts AC power from the FIND AND CORRECT THE PROBLEM BEFORE 
display unit power cord. Power to the display unit AND REPLACING THE FUSE AND TURNING THE 
‘ pedestal is controlled by the POWER switch on the front TERMINAL BACK ON! Call a qualified service 
of the pedestal. , technician if you do not have such training. 





Figure 2-20. Rear Panel. 
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PEDESTAL CONNECTORS 


The pedestal rear panel contains the following connectors. 


@ AC power connector. This connector accepts the female 
end of an AC power cord and supplies power to the ped- 
estal. The display unit and the pedestal have separate 
power cords, although power to both units is controlled 
by the terminal POWER switch on the front of the 
pedestal. 


@ Mains fuse. This is the primary fuse for the pedestal. 
Note that the display unit and the pedestal have separate 
fuses. SEE CAUTION ABOVE! To remove a bad fuse, 
unscrew the cover on the fuse holder with a flat-blade 
screwdriver; the fuse pops out when the cover is 
removed. 


@ RED, GREEN, BLUE connectors. These three connec- 
tors supply color signals (via BNC cables) to the corres- 
ponding connectors on the rear of the display unit. 


@ TO DISPLAY connector. This connector supplies control 
signals to the corresponding connector on the rear of the 
display unit. The control cable plugs into this connector 
and is secured by the two wire clips attached to the 
connector. 


@ RS232C/V.24 connector. This connector provides RS232 
output to a compatible device. This is normally used to 
connect to a host computer. 


@ TO HARD COPY connector. This connector provides 
output signals to a monochrome hard copy unit (Such as 
the TEKTRONIX 4634 Hard Copy Unit). 
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Optional Connectors 


The following connectors will be present when the indicated 
options are installed in the terminal. However, these con- 
nectors may not be in the panel location shown in 

Figure 2-20. 


@ MASS STORAGE INTERFACE (Option 45). This pro- 
vides data output to a mass storage device compatible 
with Option 45. 


REMOTE ON OUTPUT (Option 45). Supplies a Power 
On signal to the remote mass storage device. 


@ 3-PORT PERIPHERAL INTERFACE (Option 10). This 
panel provides three RS232 connectors (labeled PORT 
0, PORT 1, and PORT 2) for interface with optional 
RS232 peripheral devices. 


@ TO 4690 SERIES COPIER (Option 09). This connector 
provides color signals to a TEKTRONIX 4691 Color 
Graphics Copier. : 


@ TABLET INTERFACE (Option 13 or 14). This panel con- 
tains three connectors. The STYLUS connector accepts 
the wire that connects to the tablet stylus or cursor. The 
UPPER LEFT CORNER and LOWER LEFT CORNER 
connectors accept the corresponding wires from the 
tablet itself. 
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FILE TRANSFERS AND PERIPHERALS 


INTRODUCTION 


The purpose of this section is to introduce the concept of a 
file and file transfers, and to show how you can use various 
peripherals attached to the terminal to store and display 
information. This section is introductory in nature. It con- 
tains concepts and command examples that an experi- 
enced operator may already know. For detailed information 
on each of the commands discussed here, see the com- 
mand descriptions in Section 6. 


This section is organized as follows: 


@ Devices, Files and File Transfers 


Introduces files, devices, and file transfers, and gives a 
summary of the file transfer commands. 


@ Using Disk Drives 
Discusses all disk drive options (42, 43, and 45). 


@ Using the Three-Port Peripheral Interface 


Discusses the 3PPI (Option 10) and those instruments 
most often connected to it: plotters, printers, and tape 
drive. 
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@ Using the 4691 Color Graphics Copier 


Discusses the use of Option 09 and the 4691 Color 
Graphics Copier to make color hard copies of the display. 


@ Using a Monochrome Hard Copy Unit 
Discusses how to make black and white hard copies. 


@ Using a Tablet Option 
Discusses Option 13/14 and the use of a graphics tablet. 


Each discussion includes a physical description of the 
option (if any) — the external indicators, controls, and con- 
nectors associated with the option, and any special instru- 
ment settings that may be necessary. Then a summary of 
the commands included in this option or most often used 
with the instruments is given. Finally, some examples of 
actual command sequences to accomplish a specified task 
are given. See Section 6 for an explanation of setup com- 
mand syntax. 
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FILES AND FILE TRANSFERS 


FILES 


One of the basic units of computer information is the file. A 
computer file is used in much the same way as a business 
or personal file — to collect and store items of information 
that are related in some way. Like business files, computer 
files have names, are difficult to handle when they get too 
large, sometimes need to be moved from one place to 
another, and sometimes need to be thrown away altogether. 


To acomputer or terminal, a file is simply a stream of data 
that has a beginning and an end. The beginning of a file is 
marked by a file header that is automatically written when 
the file is created. The end of a file is marked during file 
transfer operations by an end-of-file string. This string may 
or may not be included in the file; when it is not, it must be 
explicitly supplied by either the hardware or software. You 
will see the end-of-file string referred to occasionally in this 
manual. 


Each file has a name and, on most computer systems, an 
extension. In 4110 Series terminals each file is identified by 
a name that is from one to eight characters long; it may 
have an extension from one to three characters long, sepa- 
rated from the name by a period. For example: 


MAY 15.DAT 
VITALDAT 
myfile.tx 
INITCMD 


A complete description of file name conventions is given in 
the File Names discussion near the beginning of Section 6. 


FILE OPERATIONS 


The operations you may want to perform on a file depend on 
the contents of the file. For example, files that contain 
graphic commands to the terminal will be executed — that 
is, a certain part of the terminal will read the file and execute 
any terminal commands it contains. 


There are a few basic types of operations that apply to all 
types of files; you can transfer a file, find status information 
for a file, delete a file, rename a file, and write-protect or 
unprotect a file from being deleted or modified. 


Of these types of operations, file transfer operations are the 
most important. Each file transfer locates a file on a speci- 
fied source device and transfers it to a specified destination 
device, perhaps modifying the file in some way during the 
transfer. Some examples are: 


@ Copying a file from a disk to a plotter, translating graphic 
commands that the terminal understands into graphic 
commands that the plotter can understand. 


@ Copying a file from the host onto a disk. 


@ Saving the terminal screen contents to a disk file for later 
plotting or execution. 


As these examples show, there are many different 
“devices.’’ Some of them can both send and receive data (a 
disk drive, for example), some can send data only, and 
some are not really physical devices at all. The following is a 
list of the most common “devices” that you can specify as 
sources or destinations for file transfers. Note that the colon 
is always the last character in a device name. 
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@ The following devices can be either a source or a desti- 
nation device: 


HO: The host communications port (standard). 


FO: Flexible disk drive 0. (Options 42, 43) This 
is the default drive; if you specify a 
filename without a device name, device FO: 


is assumed. 
F1: Flexible disk drive 1. (Option 43) 
SO:—S7: External mass storage devices (Option 45) 
TO: — T7: 
U0: — U7: 
V0: — V7: 
WO: — W7: 
XO: — X7: 
YO: — Y7: 
ZO: — Z7: 


@ The Option 10 peripheral ports may be sources or desti- 
nations or both, depending on what type of peripheral is 
attached. For example, a printer is a receive-only device, 
so specifying PO: as a source is invalid if a printer is 
attached to that port. Port device names are: 


PO: Port O 
P1: Port 1 
P2: Port 2 


@ The “device” SC: specifies the screen contents. Specify- 
ing this as the source device allows you to transfer the 
contents of the display using the same command format 
as for other file transfers. SC: cannot be used as a desti- 
nation. (Requires Option 09; see COPY and SPOOL 
command descriptions in Section 6.) 


@ The “device” HC: specifies a hard copy unit as the desti- 
nation device. Even though making a hard copy is not 
strictly a “file transfer,” this allows you to make hard 
copies using the same command format as for other file 
transfers. (Requires Option 09; see COPY and SPOOL 
command descriptions in Section 6.) 
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FILE TRANSFERS AND PERIPHERALS 


There are several different commands that you can use to 
transfer a file, each designed for a particular purpose. A 
summary of the file transfer commands is given in Table 3-1. 


Command 


COPY 


LOAD 


PLOT 
(Option 10) 


SAVE 


SPOOL 


STOP 


Table 3-1 
FILE TRANSFER COMMANDS 


Description 


COPY makes a copy of a specified file, leaving the 
Original file intact. The copy may have a new name, 
extension, or device location. Useful for moving files 
or making backup copies. While a COPY is in 
progress the terminal will not execute any other 
commands. 


LOAD reads a file and executes any terminal 
commands it contains. Useful for initializing the 
terminal or redrawing graphics stored on disk. 


PLOT copies the visible segments on the display to 
an output device. It is specifically designed to plot 
the screen contents on a 4662 or 4663 plotter. 


SAVE sends commands necessary to recreate 
certain items on a destination device. These items 
include macro definitions, graphic segments, and 
specified parts of the screen display. A SAVEd file 
can be retrieved and executed by the LOAD 
command. 


SPOOL is designed for “background” copy 
operations between peripheral devices. ASPOOL 
operation allows normal terminal display and host 
communications to continue uninterrupted. 


STOP halts a spooling operation in progress, closes 
the output file and saves all information already 
stored in it. 
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USING DISK DRIVES 


A disk drive is one of the most common ways to store large 
quantities of information. Disks are small and relatively 
inexpensive, and information can be retrieved quickly from 
anywhere on a disk medium. 


The terminal has three options that provide for information 
storage on disk media: 


@ Option42 One flexible disk drive, mounted in the 
terminal. Includes the Mass Storage Inter- 
face. 


@ Option43 Two flexible disk drives, mounted in the 
terminal. Includes the Mass Storage Inter- 
face. 


® Option45 The Mass Storage Interface. This option 
provides the ability to interface to one of 
the following: 


TEKTRONIX 4926 10 MB Hard Disk 


TEKTRONIX 4925/4926 Option 25 
Dual 5%4-Inch Flexible Disk 
(650 KB capacity) 
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OPTION 42/43 DESCRIPTION 


Option 42 provides one disk drive for 8-inch removable 
flexible disk storage media and a Mass Storage Interface to 
an external mass storage device (disk). Option 43 provides 
two such drives; otherwise it is identical to Option 42. Figure 
3-1 shows the terminal with Option 43 (two drives). Each 
drive includes a door, a door bar with a disk drive indicator, 
and a write-protect switch and light. 


The drive on the right is always Drive 0. In setup commands, 
specify the right disk drive as device FO: (always include the 
colon in a disk drive specification). The left disk drive, if 
present, is Drive 1 (specified as F1: in setup commands). 


The following discussions supply basic information on 
safety and handling of flexible disks. 


DOOR 


WRITE PROTECT 
SWITCH AND LIGHT 





4665-24 


Figure 3-1. Option 42/43 Flexible Disk Drives. 
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Basic Description 


Each flexible disk (Figure 3-2) consists of a thin circular disk 
of plastic coated with a metal oxide to hold magnetic 
charges. The magnetic pattern on the disk can be altered 
(written) or detected (read) by the read/write heads in the 
disk drive. The disk itself is permanently enclosed in a sleeve 
that protects the disk surface from dirt, scratches, and other 
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damage. The sleeve has openings for read/write opera- 
tions, for the disk drive spindle, etc. Each disk has a front 
and a back side; the disk label is on the front of the disk. 


Each disk/sleeve assembly is shipped in a protective enve- 
lope that is open on one side. This envelope covers approxi- 
mately three fourths of the disk/sleeve to protect the 
exposed portions of the disk. 


Pix 


Maxell 4 


Figure 3-2. Flexible Disks. 
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Inserting and Removing a Disk 


To insert a disk, open the door to the drive by pressing in on 
the door bar. Insert the disk, notched edge first, with the 
label facing up (Figure 3-3). Slide the disk all the way in, 
until it stays in; do not push so hard as to bend the disk. 
Then push down on the drive door until it clicks into place. 


To remove a disk, push in on the door bar. When the door 
opens, the disk pops out for easy removal. 


CAUTION 


Do not remove a disk while the disk drive indicator 
is on. The light indicates that the disk is currently in 
operation. Removing a disk halts the operation in 
progress, and could damage or destroy data on the 


disk. 


Always remove an ejected disk entirely from the 
drive. The drive spindle mechanism can damage the 
surface of a disk left partially inserted in the drive. 





Figure 3-3. Inserting A Disk. 
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Handling a Disk 


Flexible disks are easy to store and handle. However, it is 
important to take a few simple precautions to prevent dam- 
age to the disk and to ensure the integrity of data stored on 
the disk. 


Do not bend a disk, since the disk can crease or tear, ren- 
dering it unusable. Oil, dirt, or dust on the disk can cause 
scratches or other problems when the read/write heads in 
the disk drive access that disk area. Touch only the paper 
sleeve that encloses the disk itself. When a disk is notin 
use, keep the disk in the protective envelope to prevent 
damage to exposed disk areas. 


Store all disks in an area protected from dust and extreme 
temperatures. Temperature range should be between 
+ 50°F and + 122°F. Prolonged exposure to extreme heat 
(above 122°F) or cold (below —40°F) can ruin the disk. 


Before using a disk, leave it in the area of the disk drive for 
at least five minutes before inserting it into the drive. This 
will prevent unnecessary stresses on the disk or errors in 
information access due to sudden environmental changes. 


If you are storing critical data on a disk, make a backup 
copy of the disk periodically (perhaps at the end of each 
working day). This will protect your data in case of fire or 
accidental destruction of the disk. In fact, simply for conven- 
ience and to minimize the cost of restoring lost data, back- 
ing up a disk periodically is good practice. 


Each disk should last for about 3,500,000 read/write opera- 
tions per track, or about 30,000 insertions, whichever 
comes first. When the disk begins to wear, you will see 
translucent rings around the edges of the disk surface 
through the openings in the disk sleeve. You will also notice 
repeated errors when you try to access portions of the disk. 
When this happens, discard the worn disk and use the 
backup. 
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Write-Protecting a Disk 


There are three ways to protect information on a disk from 
being accidentally deleted or overwritten by other data. 


1. Whenthe WRITE PROTECT switch (Figure 3-1) on the 
disk drive is on, the light in the switch lights up and the 
entire disk in the drive is write-protected. You cannot 
format the disk, delete or add files, or add information 
to files on the disk. If you attempt any operation that 
would change the data on the disk, an error results. 


2. Youcan use the setup command PROTECT to protect 
individual files on a disk. This command prevents delet- 
ing and writing to a particular file; you can still copy the 
file or destroy it by reformatting the disk. 


3. Some disks also have a write-protect notch. When the 
notch is exposed you cannot write to the disk. Cover 
the notch with opaque tape to unprotect the disk. 


MASS STORAGE 
INTERFACE 

REMOTE ON 

OUTPUT 








FILE TRANSFERS AND PERIPHERALS 


MASS STORAGE INTERFACE DESCRIPTION 


The Mass Storage Interface (Option 45) provides the termi- 
nal with an interface to the TEKTRONIX 4926 Hard Disk and 
to the 4925 (4926 Option 25) Dual5%-Inch Flexible Disk 
Drive. The 4925 uses 5%-inch removable flexible disks. The 
same considerations of handling and safety apply to these 
disks as to the 8-inch disks discussed earlier. 


The 4926 Hard Disk uses 5%-inch rigid Winchester disk 
technology. These disks are not removable. The closer 
tolerances possible with the fixed disk permit much greater 
storage capacity than on removable disks of the same size. 


The Option 45 panel is located on the rear of the terminal 
pedestal (Figure 3-4). It contains two connectors. The 
MASS STORAGE INTERFACE connector accepts an MSIB 
cable from the storage device. The REMOTE ON OUTPUT 
connector supplies a power-on signal to the storage device, 
allowing the terminal to control power in the storage device 
itself. 


Figure 3-4. Option 45 Rear Panel Connectors. 
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DISK DRIVE COMMAND SUMMARY 


Table 3-2 presents a summary of the setup commands that 
relate to general disk drive operation. Section 6 contains 
detailed descriptions of device and file name conventions 
and the individual commands. In general, anytime you can 
specify a disk mounted in the terminal, the command syntax 
allows an Option 45 device as well (assuming the option is 
installed and a storage device is attached). 


Table 3-2 
SUMMARY OF DISK DRIVE COMMANDS 


Command Description 

COPY Copies a file from one device to another. (Original 
is left intact.) 

DELETE Deletes a file from the disk. 

DIRECTORY Creates a directory of a disk or of a single file. 

DISMOUNT Instructs the terminal that a disk has been 

; changed. 

FORMAT Prepares a disk to store data. WARNING!! 
Formatting a disk destroys all data previously 
stored there. 

LOAD Reads a file from a disk into the terminal’s 
command processor; any terminal commands in 
the file are executed. 

PLOT Sends information from the screen to an output 

(Option 10) device, encoding graphic information as escape 
sequences. 

PROTECT Write-protects or unprotects individual disk files. 

RENAME Renames a file. The location and contents of the 
file are unchanged. 

SAVE Saves selected information for later use by the 
LOAD command. 

SPOOL Copies a file from one device to another while 
allowing other terminal operations to continue. 

STOP Halts a spool operation. : 

USERNUMBER | Sets a user number for file access. All disk 


operations (except FORMAT) access only 
information marked by the current user number. 
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EXAMPLES OF USE 


Formatting a Disk 


Before a disk can be used to store data, it must be format- 
ted — that is, prepared to store data. Information is stored 
on a disk in a certain physical arrangement involving tracks 
(concentric rings) and sectors (Subdivisions of tracks). Dur- 
ing formatting, address labels are written at the beginning of 
each track and each sector. Information is also written on 
the disk to synchronize the action of the read/write heads 
with the portion of the disk under the head, allowing the 
head to find the proper location. 


But most importantly for you, the operator, disk space is 
conceptually organized into blocks and directory entries. 
These terms do not refer to physical parts of the disk, but 
how space on the disk is allocated to files that are created 
and modified. 


The number of directory entries is fixed for each type of 
disk. Each file requires at least one directory entry. A file 
may require more than one directory entry, depending on 
the file length; however, at least one is required. This means 
that the number of directory entries is the maximum number 
of files that you can store on one disk. The number of direc- 
tory entries depends on the storage capacity of the disk. 
See the FORMAT command description in Section 6 for 
details. 


When you add information to a file, the system allocates 
additional file space in predetermined sized chunks called 
blocks. The size of a block depends on the disk format and 
is listed whenever you do a DIRECTORY command for that 
disk (or a file on that disk). Typical block sizes are 1024 
bytes or 2048 bytes (characters). 


Initially, when a file is created, one block is allocated to the 
file. AS you add information to the file, the size of the file is 
increased in one-block increments to allow for the added 
information. Using a block structure keeps the disk control- 
ler circuitry from having to update the file size continually, 
but keeps unused space in the file to a minimum by using a 
relatively small block size. 
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This information sounds rather technical, and you do not 
need to understand it to format and use a disk. But it will 
help you to interpret the directory messages that appear on 
the screen. See the DIRECTORY and FORMAT commands 
in Section 6 for details. 


Disks are not formatted at the factory because the required 
formatting information varies with the disk drive design. 

Also, formatting information could be destroyed by contact 
with magnetic or electrical fields in shipping. Therefore, the 
user must format each disk before storing information on it. 


Formatting a disk destroys all data stored on the 
disk. Make sure you no longer need this data before 
you format the disk. 


To format a disk, insert the disk in the appropriate disk drive 
(for removable disks) and enter the FORMAT command. 
The simplest version of the command simply formats the 
disk in a fashion determined by the physical size and type of 
the disk. For example: 


FORMAT FO: 


In some cases you may want to format a fixed disk to con- 
form with the data format required by the TEKTRONIX 4170 
Graphics Processing Unit. To do this, include the string “/C”’ 
after the device name. For example: 


FORMAT S0:/C 


Finally, it is possible that certain tracks on a fixed disk are 
Known to be unreliable. (This information may be included 
with the disk when it is shipped from the manufacturer.) In 
that case you can format the disk to exclude those tracks 
from use by including up to five strings of the form “/track” 
in the device name, where “track” is a track number. For 
example, suppose you know that tracks 23, 29, and 37 are 
“bad.” If the disk is already in use and if it is necessary, 
make a backup copy of the data on the disk. Then format 
the disk with the command: 


FORMAT S0:/23/29/37 


This will prevent these tracks from being accessed, while 
allowing the rest of the disk to be used normally. 
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The USERNUMBER Command 


It is possible, especially on a high-volume fixed disk, that 
several users will share the same disk. In such cases, it is 
desirable to protect each user’s data from accidental dele- 
tion by other users. For example, suppose you have a file 
called MYDATA.NUM on the disk in device SO:. If another 
user of that disk decides to delete or create a file with the 
same name, your file could be destroyed. 


To avoid such problems, you can specify a user number for 
each user of the disk. Whenever a file is created on that 
device, the file is marked with the current user number. 
Most disk operations access only files marked with the 
current user number. For example, when you give a 
DIRECTORY command, only files marked with the current 
user number are listed. 


The terminal powers up with the user number set to zero. 
When you begin a work session, simply set the correct user 
number. For example, if your user number is 9, give the 
following command at the start of your work session: 


USERNUMBER 9 


Then COPY, DELETE, DIRECTORY, and similar commands 
will only access files marked with your user number, and 
any files created will be so marked. 


Changing a Disk 


NOTE 


Some devices are able to detect a disk change 
automatically and do not require you to enter the 
DISMOUNT command. 


When you change a disk, you must notify the terminal with 
the DISMOUNT command. This instructs the terminal to 
scan the new disk for allocation and block information (for 
example, for the amount of free space and for bad track 
numbers) before accessing the disk. If you change disks 
and do not notify the terminal, it is possible that data will be 
lost or incorrectly written or read. 


The following command notifies the terminal that the disk in 
drive FO: has been replaced: 


DISMOUNT FO: 
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Disk Directories 


One of the first things you may want to know about a disk is 
what information — what files — it contains. Simply give a 
DIRECTORY command with the appropriate device name; 
for example: 


DIRECTORY FO: 


This command prints a directory of the disk in drive 0 on the 
terminal screen. It also lists how many blocks on the disk 
have been used and how many are free (unused), how 
many directory entries are used and how many are free, and 
the disk block size. 


If you want, you can output the directory to some other 
device than the terminal screen. Just include the keyword 
to, followed by a destination device. For example, the fol- 
lowing command sends a directory of the disk in drive 0 to 
an output device (Say a printer) attached to peripheral port O 
(Option 10): , 


DIRECTORY FO: to PO: 


To use this form of the DIRECTORY command, you must 
have an output device attached to Port 0, and Port 0 must 
be properly configured for the output device. See Using the 
Three-Port Peripheral Interface discussion later in this 
section. 


You can also save the directory by creating a file and storing 
it there; for example: 


DIRECTORY FO: to FO:FODIRECT 


This command creates a directory of the disk in drive 0 and 
stores it in a file called FODIRECT on the same disk. 
(Remember that filenames must be no more than eight 
characters long.) Note that the source device and destina- 
tion device are the same in this command. 
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Finally, you can ask for the directory of a specific file by 
including the filename in the source device: 


DIRECTORY F0:TESTDATA.NUM 


This command lists directory information for the file called 
TESTDATA.NUM on the screen. This information includes 
the length of the file in blocks and its write-protect status. If 
you want to copy a file to a disk but suspect there may not 
be enough space on the disk, just do a directory of the file 
and of the disk to check whether there is sufficient room. 


As with all file commands, only files marked with the current 
user number are listed. The entry and block information, 
however, refers to the entire disk. 


Figure 3-5 shows a sample disk directory and a sample 
directory of an individual file. 


DRIVE FO: USER NUMBER 12 






-NAME — _ PROTECT 
PRACTICE EME .«.-—=s—=«<‘( S;S;C#‘éNSS 
HAVE Re 
GOOD. AX ho. 
NEWOATA DAT CONS 
“INITIAL GMD) lise. COTES 
SENTRIGS USED: #36... 
| wENTRIES FREE: #288 . | 
_ -BLOCKS FREE: #218... 
| BLOCK SIZE: #2045 
f . 
DRIVE FO: *USER NUMBER 12. 
NAME |. cS 












Figure 3-5. Sample Directories. 
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Changing a File Name 


Sometimes you may want to change the name of a file, 
perhaps to use the old name for another file or because the 
status of the file has changed. To change a file name, use 
the RENAME command. 


For example, suppose you have been working on a file of 
tentative information called EXPER4.TMP. This file is on the 
disk in drive 0 and contains information on seismic tremors 
from Experiment #4. It has an extension of TMP since itis a 
“temporary” file. Now the experiment is complete and you 
wish to mark this file for statistical analysis. One way to do 
this is to rename the file: 


RENAME EXPER4.TMP TO QUAKE-37.DAT 


Drive 0 is the default device, so you need not specify the 
device in this command. 


Deleting a File 


When you no longer want to keep the information in a file, 
you can delete the entire file with the DELETE command. 


Deleting a file destroys all information in the file. 
Be sure that you no longer need information in the 
file before you delete it. 


Only files marked with the current user number will be 
deleted. You must specify both the file name and the exten- 
sion for the file you want deleted. For example, to delete a 
file on device FO: called OLDDATA.PDQ enter the following: 


DELETE F0:O0LDDATA.PDQ 
This command would not delete the following: 


OLDDATA 

OLDDATA.PDX 

OLDDATA.PDQ marked with a different user number 
OLDDATA.PD@Q on another device 
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Protecting a File 


Earlier in this discussion you learned how to protect an 
entire disk from being changed by using the WRITE PRO- 
TECT switch on the disk drive. Sometimes you may want to 
protect a particular file from being accidentally deleted or 
written to, while allowing access to other files on the disk. To 
protect or unprotect a single file, use the PROTECT com- 
mand with the filename and one of the keywords yes or no. 
For example, to write-protect a file called VITAL.DAT on the 
disk in drive 0, enter either of the following: 


PROTECT FO:VITAL.DAT yes 
PROTECT FO0:VITAL.DAT 


The keyword yes is optional. To unprotect this file so you 
can write new information in it or delete it, enter the com- 
mand with the keyword no, like this: 


PROTECT FO:VITAL.DAT no 


Transferring Disk Files 


As Table 3-1 indicates, each file transfer command is 
designed for a particular purpose. In this discussion, sev- 
eral examples of transfers to or from a disk are given. 


COPY With Disk Files 


One of the most useful commands is the COPY command. 
It provides a general file transfer capability. For example, to 
copy a file from one disk location to another, just give the 
COPY command with the appropriate source and 
destination: 


COPY F0:NEWDATA.DAT TO S1:DATA37.DAT 


Note that you can change the file name when you copy it, 
and the old file is left intact. Here, the file NEWDATA.DAT is 
still on the disk in drive 0, and remains there until you delete 
it. Note also that FO: is the default device, so you could 
shorten this command to: 


COPY NEWDATA.DAT TO S1:DATA37.DAT 
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The destination disk and the source disk can be the same 
disk, as long as the file names do not conflict. For example, 
you cannot perform the following file copy: 


COPY F0:RESULTS TO FO:RESULTS 
However, you can do the following: 


COPY FO:RESULTS TO F0:RESULTS.SAV 
or 
COPY F0:RESULTS TO PERMDATA 


COPYing To and From a Host. The COPY command can be 
used to transfer files between the host computer and a 
device attached to the terminal. One use would be to copy 
an initialization file from the host to a disk file; this file would 
later be LOADed to the terminal to initialize it for a given 
applications task. For example: 


From host 


EOFSTRING “*/**/” 
or keyboard 


COPY HO: to FO:INIT.CMD 


DEFINE < macro definition > 
DEFINE < macro definition > 


BAUDRATE < proper baud rates > 


PARITY <proper parity setting > From host 
(other initialization commands) 
/**/ (the end-of-file string) 

EOFSTRING } From host 


or keyboard 


This is a “model” of a copy from the host; an initialization 
file called INIT.CMD is created on the disk in drive 0, and 
various terminal commands are copied into it. (Note how- 
ever that commands from the host would be sent using 
escape sequence syntax.) 


' The first EOFSTRING command sets the end-of-file string 
to /**/. The COPY command instructs the terminal to copy 
incoming data from the host port to a file called INIT.;CMD on 
the disk in drive 0. The DEFINE commands program 
selected keys with macro definitions. The BAUDRATE com- 
mand sets the data transmission rates to use. (These may 
vary with the application; a program that involves text edit- 
ing would not need to transmit data as fast as an interactive 
data analysis program in which large amounts of data were 
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transferred.) The line /**/ is the end-of-file string; this tells 
the terminal that the COPY operation into INIT.CMD is com- 
plete. The terminal ends the copy operation and closes the 
disk file. The next EOFSTRING command resets the end-of- 
file string to the null string; this allows the bit pattern that 
defines the string /**/ to be used for other purposes (per- 
haps as encoded graphic coordinates or integer parameters 
for some terminal command). 


If the source device is the host (HO:), you must begin the 


data transmission before entering the COPY command. 


Once you enter the COPY command the terminal waits for a 
data stream from the host until it receives an end-of-file 
string or until the CANCEL key is pressed. 


One way to arrange the proper sequence of events is as 
follows: 


1. Exit Setup mode and enter the host command to begin 
sending data, but leave out the host’s end-of-command 
character (typically a Carriage Return). 


2. Enter Setup mode. 


3. Enter the COPY command with the desired destination 
device. 


4. Exit Setup mode. (The SET UP light stays on because 
the COPY command is still being executed.) 


5. Enter the host’s end-of-command character. (If your 
host uses remote echo, this causes the end-of-com- 
mand character to be the first character in the data 
stream.) 


Another way to do this is to program the host so that there is 
a delay between the time it receives the end-of-command 
character and the time it begins sending data. Make this 
delay long enough so that you have enough time after you 
enter the host send-data command to put the terminal in 
Setup mode, enter the COPY command, and leave Setup 
mode. The sequence would then be: 


1. Exit Setup mode (if necessary) and enter the send-data 
command to the host. 


2. While the host delays, enter Setup mode and type in 
the COPY command with HO: as the source and the 
appropriate destination. 


3. Exit Setup mode. When the host delay is over, it will 


begin sending data to the terminal, which is now ready 
to receive it. 
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If the host is the destination device (you are copying from 
the terminal or some peripheral attached to the terminal to 
the host), you must likewise make sure that the host is ready 
to receive data before the COPY command is entered. 
Otherwise data will be lost. Procedures for this vary with the 
host. 


The SPOOL Command 


One disadvantage to the COPY command is that the termi- 
nal cannot perform any other functions while the COPY 
operation is in progress. This can be inconvenient when the 
destination device is relatively slow. For example, you can 
copy a text file from the host computer to a printer attached 
to peripheral port 0 with the following command: 


COPY HO: TO PO: 


However, the terminal cannot perform any other functions 
until the printout is completed, which may take several 
minutes. Another example would be making a color hard 
copy of the screen display. Since current color copier tech- 
nology outputs data at a much slower rate than the terminal, 
time is lost when the terminal could be working on other 
tasks. 


The SPOOL command allows you to perform “background” 
transfers of information from a disk file. The idea is first to 
COPY the information to a disk file (if necessary) since this 
is a relatively fast operation. Then use the SPOOL com- 
mand to transfer the disk file to the output device, leaving 
the terminal free to do other tasks. For example, to copy a 
text file from the host to a printer, replace the single com- 
mand COPY HO: TO Po: by the two commands: 


COPY HO: TO FO: TEMPFILE. TX 
(Host-to-disk copy executes rapidly) 
SPOOL F0O:TEMPFILE.TX TO Po: 


This allows the terminal to proceed to other tasks as soon as 
the copy into the disk file from the host is complete. Data is 
“spooled” from the disk file to the printer without tying up 
the terminal. 


A SPOOL operation in progress can be halted, if necessary, 
by entering the STOP commana. If the output is a file, the 
file is closed and any information already spooled is saved. 


SPOOL can also be used in place of a PLOT command, for 
the same reason given for COPY: to avoid tying up all termi- 
nal functions during output to a a relatively slow device. See 
Using A Plotter later in this section. 
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The SAVE Command With Disk Files 


The SAVE command allows you to save macro definitions or 
graphic segments as escape-sequence commands. Later 
you can read this file and execute the escape sequences in 
it with the LOAD command. 


The following examples show how this command might be 
used. 


SAVE SEG 1 TO FO:SEGMENT1 
Saves graphic segment number 1 as a series of escape- 
sequence commands in the disk file named SEGMENT1. 


SAVE MAC 128 TO FO0:MACRO.65 

Saves macro definition number 128 (associated with Function 
Key 1) as a series of escape-sequence commands in a disk file 
named MACRO.65. 


SAVE SEG -1 TO SEGMENTS 
Saves all graphic segment definitions as series of escape- 
sequence commands in a disk file named SEGMENTS. 


SAVE can be used to send information to other destinations 
than disk files. For example: 


SAVE SEG 3 TO PO: 


If a plotter is connected to Port 0, this will cause graphic 
segment 3 to be drawn on the plotter. (The port and plotter 
must be properly configured; see the Using A Plotter dis- 
cussion later in this section. Also see the SPOOL 
discussion.) 


The LOAD Command With Disk Files 


The LOAD command sends a file to the terminal’s com- 
mand processor, which executes the file just as if these 
commands had been sent from the host. Common uses for 
LOAD are to recreate graphic displays or to initialize the 
terminal for some applications program from the host (set 
baud rates, key definitions, etc.). For example, to execute 
the sample file INIT.CMD created in the COPY discussion 
earlier, just enter: 


LOAD INIT.CMD 


Since the file is on device FO:, the default device, no device 
name is needed. 


Another application involves storage and retrieval of graph- 
ics. Suppose a file named MODEL32.DAT is stored on the 
disk in drive 0. The following command will read the file, 
causing graphics commands to be executed by the terminal 
and the graphics information in the file to be displayed: 


LOAD F0:MODEL32.DAT 
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USING THE THREE-PORT 
PERIPHERAL INTERFACE 


Option 10, the Three-Port Peripheral Interface, provides 
RS232 communications support. The specific TEKTRONIX 
products supported by the 3PPI (Three-Port Peripheral 
Interface) are: 


@ The 4662 Interactive Digital Plotter 

@ The 4663 Interactive Digital Plotter 

@ The 4643 Matrix Printer 

®@ The 4923 Option 01 Digital Cartridge Tape Drive 


The Option 10 rear panel connector (Figure 3-6) contains 
three RS232 connectors, labeled PORT 0, PORT 1, and 
PORT 2. 


The 3PPI uses device drivers to support specific devices 
attached to one of the peripheral ports. A device driver is a 
program that interfaces the terminal with a specific device 
attached to the port. For example, some devices may 
require certain characters as part of their communications 
protocol; a device drive would make sure that these charac- 
ters are present when required. 





The 3PPI supports any RS232 device using its PPORT 
driver, which simply passes data through the port without 
any formatting. To set up Port 0 with the general PPORT 
driver, give the following command: 


PASSIGN P0: PPORT 


You can format output to the 3PPI for specific Tektronix 
devices with the setup command PASSIGN. For example, 
you can connect a 4663 plotter to Port 0, and configure the 
port with the following command: 


PASSIGN PO: 4663/T 


This command assigns the 4663 device driver to Port 0; it 
also instructs the driver to translate terminal commands 
into 4663 commands in data sent to the plotter. See the 
PASSIGN command description in Section 6 for details. 


You can also use various setup commands to assign com- 
munications parameters to a peripheral port, much as you 
assign these parameters to the host port. Just as with the 

host, these parameters must be set to the values required 
by the device attached to the port, or communications will 
be garbled. The various port configuration commands are 
summarized under the following heading. 


TABLET INTERFAL 


Figure 3-6. Three-Port Peripheral Interface Panel. 
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COMMAND SUMMARY 


Table 3-3 summarizes the commands used with the 3PPI. 
Each of these commands is discussed in detail in Section 6 
of this manual. However, refer to the 47/0 Series Host Pro- 
grammers Manual for the basic concepts of port communi- 


cations. 
Table 3-3 
THREE-PORT PERIPHERAL INTERFACE 
COMMAND SUMMARY 
Command Description 
PASSIGN Assigns a device driver to a specified port. 
PBAUD Sets the baud rate for a specified port. 
PBITS Sets the number of stop bits and data bits fora 
specified port. 
PCOPY Establishes a two-way communication path 
between two devices. 
PEOF Sets the end-of-file string for the specified port. 
PEOL Sets the end-of-line string for the specified port. 
(Used only with the 4643 device driver.) 
PFLAG Sets the flagging method used by the specified 
port. 
PLOT Sends information to a plotter. 
PPARITY Sets the parity used by a specified port. 
STATUS 3PPI Displays a status report for all peripheral ports. 
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USING A PLOTTER 


CONNECTING THE PLOTTER 
TO THE TERMINAL 


When using a TEKTRONIX 4662 or 4663 Interactive Digital 
Plotter, connect the plotter’s ““modem” connector to one of 
the terminal’s three RS-232 peripheral ports. 


NOTE 


Do not connect the plotter between the terminal’s 
host port and the host computer. Although the 
plotter is designed to run in this configuration, the 
terminal design assumes that the plotter is con- 
nected to one of the RS-232 peripheral ports. 


INITIALIZING THE PORT 


To use a TEKTRONIX 4662 or 4663 Interactive Digital Plot- 
ter with the terminal’s RS-232 peripheral port, you must set 
the plotter’s switches and the peripheral port settings ina 
compatible way. For instance, if the plotter is set to operate 
at 1200 baud, then the peripheral port to which it is attached 
must also be set for 1200 baud. The terminal’s plotter driv- 
ers always use device address A. 


4662 Plotter. Table 3-4 shows one way the switches on the 
TEKTRONIX 4662 Digital Plotter can be set for communi- 
cating with the terminal through the terminal’s Option 10 
Three Port Peripheral Interface. | 


Table 3-4 
4662 PLOTTER SETTINGS 


Switch 


Setting 
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These switch positions set the 4662 as follows: 


Copy mode. 

CR implies CR-LF. 

GIN terminator = CR. 
Number of stop bits = 1. 
No Parity. 

Plotterdevice address = A. 
Baudrate = 1200. 


With the 4662’s switches set as in Table 3-4, the following 
SETUP mode commands will then initialize peripheral port 
zero for communicating with the plotter. The terminal 
remembers these settings even when turned off; thus the 
commands need only be issued once, when attaching the 
plotter to the terminal. 


PBAUD PO: 1200 
Sets port zero to communicate with the 4662 at 1200 bits per 
second. 


PASSIGN P0: 4662 

Assigns the standard “4662” device protocol to peripheral port 
zero. (If the 4662 is equipped with multiple pens — Option 31 
— then the second parameter in this command should be 
“4662/MP” rather than “4662.) 


PPARITY P0: NONE 

PBITS PO: 1 8 

Sets peripheral port zero to send ASCII characters which have 
eight data bits, no parity bit, and one stop bit. 


PFLAG PO: NONE 

Disables DTR/CTS and character flagging at the peripheral 
port. (Instead, the plotter’s block mode is used to prevent data 
overrun.) 
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4663 Plotter. Table 3-5 shows one way to set the 4663 plot- 
ter’s parameter entry switches for use with the terminal. 


Suppose the plotter switches have been set as shown in 
Table 3-5. In that case, the following SETUP mode com- 
mands initialize peripheral port zero in the terminal for 
proper communication with the plotter: 


PBAUD PO: 9600 
Sets peripheral port zero to communicate with the plotter at 
9600 bits per second. 


PASSIGN P0: 4663 
Assigns the “4663” device protocol to peripheral port zero. 


PPARITY PO: NONE 

PBITS PO: 1 8 

Sets peripheral port zero to send ASCII characters which have 
eight data bits, no parity bit, and one stop bit. 


PFLAG PO: NONE 
Disables DTR/CTS and character flagging. (instead of flag- 
ging, the plotter’s block mode protocol is used to prevent data 


overrun.) 
Table 3-5 
4663 PLOTTER SETTINGS 
Parameter Setting 
Initial aspect ratio 4X:3Y 


Y vertical, X horizontal 
1 (RS-232 interface) 


3 (emulates a 4662) 


Initial axis orientation 
Interface select 


Initial command response format 


Serial device address A 

Receive baud rate 9600 

Transmit baud rate 9600 

Transmit baud rate limit Full speed 
Character format 8 data bits, 1 stop bit 


Ignore/logic zero 
Full duplex 


CR generates LF = YES, 
DEL IGNORE = NO 


Attention character ESC 
Output terminator CR 


Receive parity/transmit parity 
Communications control mode 
Interface functions 
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EXAMPLES OF USE 


The following show several command sequences that will 
transfer data to a plotter. 


DIRECTORY to a Plotter 


To send a directory to the plotter, the following conditions 
must be met: 


@ The plotter must be set for “CR implies LF’, since each 
line in the directory report ends with °r, NOT with Cr’. 


@ Other plotter parameters required are: 


Attention character Ec 


Address character A 


@ The port device driver should have an “NT” parameter 
assigned by a PASSIGN 4662/NT or PASSIGN 4663/NT 
command. 


@ You (the operator) must position the plotter pen (with the 
plotter’s joystick) to the upper left corner of the plotter’s 
viewport. 


Once these conditions are met, simply give a DIRECTORY 
command to the port to which the plotter is connected. For 
example, if the plotter is connected to Port 0, the following 

command outputs a directory for the disk in drive 0: 


DIRECTORY FO: TO PO: 
Remember that device names must include the colon; Port 


0 is device PO:, not simply PO. 


The PLOT Command 


You can draw all visible graphic segments in the current view 
on an attached plotter by using the PLOT command. For 
example, if a plotter is attached to peripheral Port 0, just 
give the command: 


PLOT TO PO: 


This command also assumes that the port has been cor- 
rectly configured to receive output for the attached plotter 
(see the PASSIGN command). 


Note, however, that this command will tie up all other termi- 


nal operations until the PLOT is complete. A more efficient 
method is to use the SPOOL command discussed later. 
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SAVEing to a Plotter 


The SAVE command, although normally used for file crea- 
tion, will format data in a single graphic segment to allow it 
to be drawn correctly on to a plotter. Just give the SAVE 
command with a segment number. For example, if a plotter 
is attached to peripheral Port 1, you can plot segment 3 by 
giving the following command: 


SAVE SEG 3 TO P1: 


However, this will tie up terminal operations until all of seg- 
ment 3 has been plotted. A more efficient way is to use the 
SPOOL command discussed next. 


You can also save various classes of segments with SAVE; 

see the command description in Section 6. 

SPOOLing to a Plotter 

As mentioned earlier, although you can PLOT or SAVE 

information directly to a plotter, it is generally more efficient 

first to save that information in a disk file, then spool from 

the disk file to the plotter, since spooling frees the terminal 

for other functions. For example, suppose a plotter is 

attached to Port 0. To plot all visible segments, replace: 
PLOT TO Po: 


with the two commands: 


PLOT TO FO: TEMPFILE 
SPOOL F0:TEMPFILE TO PO: 


To plot a particular segment, replace: 
SAVE SEG 3 TO PO: 
with the two commands: 


SAVE SEG 3 TO F0:TEMPFILE 
SPOOL FO: TEMPFILE TO PO: 


A spooling operation in progress can be halted with the 
STOP command. 
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Direct Host-to-Plotter Copy 


The commands discussed so far all depend on the termi- 
nal’s ability to translate 4110 Series escape-sequence com- 
mands to equivalent plotter commands. However, it is 
possible to copy from the host directly to the plotter, without 
using the terminal firmware at all. 


To do this you can use COPY or SPOOL with the port 
assigned an “NT” parameter (PASSIGN 4662/NT or 
4663/NT). This allows data to be sent directly to the plotter 
without translation. You can also use the PCOPY (Port- 
Copy) command. The advantage of PCOPY is that it sets up 
a two-way data path between the plotter and the host. This 
allows plotter status information, error codes, and GIN 
points to be sent from the plotter back to the host. See the 
4110 Series Host Programmers Manual for details. 


USING A PRINTER 


The 3PPI supports RS232 communication with the 
TEKTRONIX 4641, 4641-1, and 4643 Matrix Printers. The 
following tables show how to set up a peripheral port for 
sending data to one of these printers. 


Table 3-6 
PORT SETTINGS FOR PRINTERS 


Command 4641(-1) Settings 
PBAUD 9600 

PPARITY | NONE =——__—s|.- NONE 

PFLAG DTR/CTS 
PASSIGN 4643 


3-18 


Setting the switches shown in the following tables 
requires opening the printer covers. DO NOT 
OPEN THE COVERS WHEN THE PRINTERIS 


TURNED ON. 


Table 3-7 


4643 SERIAL INTERFACE BOARD SETTINGS 


Switch 
S1-1 
$1-2 
$1-3 
S$1-4 
S2-1 
S$2-2 
S$2-3 
S2-4 
S3-1 
$3-2 
$3-3 
S3-4 
S14-1 
$14-2 
$14-3 
S14-4 
$14-5 
$14-6 
$14-7 
$14-8 
$15-1 
$15-2 
$15-3 
S15-4 
$15-5 
S$15-6 
$15-7 
$15-8 


Setting 


ON 
ON 
OFF 
AID 
ON 
ON 
ON 
AID 
OFF 
OFF 
OFF 
OFF 
OFF 
OFF 
OFF 
ON 
OFF 
OFF 
OFF 
OFF 
AID 
OFF 
OFF 
OFF 
ON 
OFF 
AID 
OFF 
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Table 3-8 
4641(-1) INTERFACE CARD SETTINGS 


Switch Setting 





EXAMPLES OF USE 


DIRECTORY to a Printer 


You can output a disk or file directory to an attached printer 
with the DIRECTORY command. For this to work, the port’s 
end-of-line string must be set to Cr'r by the PEOL com- 
mand. This instructs the terminal to send Cr'r at the end of 
each line in the directory message, rather than just Cr. 


The other port communication parameters must match 
those of the printer. See the 3PPI Command Summary 
discussion. 


Once these conditions are met, just give the DIRECTORY 
command with the proper peripheral port as the device 
name. For example, suppose a printer is attached to Port 0 
and the port has been properly configured. To print a direc- 
tory of the disk in drive 0 on the printer, just give the com- 
mand: 


DIRECTORY FO: TO PO: 
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COPYing to a Printer 


Data can be transferred to a printer with the COPY com- 
mand. For example, to output a text file called RESULTS on 
the disk in drive 0 to the printer attached to Port 0, give the 
following command: 


COPY RESULTS TO PO: 


Note that since device FO: is the default device, no “FO:” 
designation is needed on the source. Also note that a COPY 
command ties up the terminal until the COPY is completed; 
if the file to be copied is of any length, it is probably better to 
use the SPOOL command, discussed next. 


SPOOLing to a Printer 


As mentioned earlier, spooling allows “background data 
transfers” between devices, allowing the terminal to per- 
form other activities while the transfer is in progress. For 
example, instead of sending a disk directory to the printer 
with a DIRECTORY command, you could send it first to a 
disk file and then spool it from the disk file to the printer 
while using the terminal for other tasks. To send a directory 
of a disk in drive 0 to a printer attached to Port 0, give the 
following commands: 


DIRECTORY FO: TO FO:DIRECT 
SPOOL FO:DIRECT TO Po: 


Since FO: is the default device, the commands could be 
given as: | 


DIRECTORY TO DIRECT 
SPOOL DIRECT TO PO: 


A spooling operation in progress can be halted with the 
STOP command. 
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USING THE 4923 TAPE DRIVE 


You can attach a TEKTRONIX 4923 Digital Cartridge Tape 
Drive with Option 01 installed to one of the terminal’s 
peripheral ports. Plug the RS-232 cable into the MODEM 
connector on the tape drive and into one of the 3PPI con- 
nectors on the rear of the terminal. Then configure that port 
(say, Port 0) with the PASSIGN command: 


PASSIGN P0: PPORT 


Use the PBAUD command to set the port baud rate to 
match the tape drive’s baud rate (shown by the tape drive’s 
baud rate control knob on the back of the drive). 


Use the PFLAG command to set terminal flagging to 
“DC1/DC3”’. Set all other port communication parameters 
to match the conventions used in files to be stored on the 
tape. 


When the terminal is receiving data from the tape drive, you 
can indicate an end-of-file by pressing the terminal’s CAN- 
CEL key after the data has been transferred. This erases 
the last received data that would otherwise be left inside the 
3PPI. 


USING OTHER RS232 DEVICES 


You can use the 3PPI with any RS232 device as long as the 
port communication parameters are compatible with or 
match those of the attached device. In particular, the 
PPORT (general purpose peripheral port) device driver 
should be assigned to the port with the command: 


PASSIGN Px: PPORT 
Here x is the appropriate port number (0, 1, or 2). 


The other port settings depend on the requirements of the 
particular device. 
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USING A 4691 COLOR COPIER 


With Option 09, the 4691 Color Graphics Copier Interface, 
installed the terminal can make color copies of the screen 
display. The Option 09 interface includes a connector 
labeled TO 4690 SERIES COPIER on the back of the termi- 
nal, and special commands for making color copies. 


To connect the color copier, attach the copier’s cable to the 
TO 4690 SERIES COPIER connector on the terminal’s back 
panel. Secure the cable to this connector with the wire clips 
attached to the connector (Figure 3-7). 


Option 09 includes the following commands: 


HCDATARES { 1 } 
2 

Sets the precision of data sent to the copier. A resolution of 2 

makes higher resolution hard copies, but takes longer to make 

each copy. 


HCINTERFACE { color 

mono } 
Allows you to select either a color copier or a monochrome 
hard copy unit to make copies in response to a copy request. 


HCORIENT { horizontal 

vbottom 

vcenter 

vtop 
Sets the orientation of the copied image on the copy medium. 
HCCOPIES n 


Sets the number of hard copies produced by each copy 
request to 7, where 7 is an integer. 


Each of these commands is explained in detail in the com- 
mand descriptions in Section 6. 


You can make hard copies of the screen on a monochrome 
hard copy unit with the standard terminal (see Using A 
Monochrome Hard Copy Unit discussion following). How- 
ever, if you have Option 09 installed, you can still make 
copies on a monochrome hard copy unit by selecting the 
monochrome interface with the command: 


HCINTERFACE mono 


Once the interface is selected, it remains set until you 
change it or turn off the terminal. 
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Hard copies are produced when: 


@ The terminal receives a <hardcopy > escape sequence 
command. 


@ The terminal receives a <4010-hardcopy > escape 
sequence command. 


@ You (the operator) press the HARD COPY key, either 
shifted or unshifted. The unshifted HARD COPY key 
makes a copy of the screen just as it appears. The 
shifted HARD COPY key makes a “reverse video” 
image, with black copying to white and white to black (for 
color copies, other colors copy as they appear on the 
screen). 
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@ You give the following setup command: 
COPY SC: TO HC: 


This command copies the pixel viewport to the attached 
hard copy unit. Since this ties up all terminal functions 
until the hard copy is complete, you may first want to 
copy the screen to a disk file and spool it from the disk to 
the hard copy unit: 


COPY SC: TO F0:COLORCPY 
SPOOL FO0:COLORCPY TO HC: 


See Section 6 for details on COPY, SPOOL, and other hard 
copy commands. 


COLOR COPIER 
CONNECTOR 


TAGLET INTERFACE 


Figure 3-7. Color Copier Connector. 
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USING A MONOCHROME HARD 
COPY UNIT 


The standard terminal is compatible with the TEKTRONIX 
4632 and 4634 Hard Copy Units. These units provide mono- 
chrome or gray-scale copies. Simply attach the hard copy 
unit cable to the TO HARD COPY connector on the stand- 
ard back panel (Figure 3-8), then turn on the unit. 


A monochrome hard copy unit should be on for about 10 
minutes before you make copies with it. If the unit is not 
warmed up, copies will be faint or entirely white. 


To make a copy, press the HARD COPY key on the termi- 
nal’s keyboard or the COPY key on the hard copy unit. 
Color displays produce gray-scale monochrome copies, 
with each color being mapped to a unique gray (see the 
CMAP command description in Section 6). Pressing Shift- 
HARD COPY makes a “reverse video” copy, with white 
copying to black and black to white. 


If the terminal has Option 09, 4691 Color Graphics Copier 
Interface, installed, you can select either the monochrome 
hard copy unit or the color graphics copier with the HCIN- 
TERFACE command. See the Using the 4691 Color Graph- 
ics Copier discussion earlier in this section. 





USING A TABLET OPTION 


The two graphics tablet options (Options 13 and 14) are the 
same except for the size of the tablets. Option 13 contains 
an 11x11 inch tablet; Option 14 contains a 30x40 inch tab- 
let. Since the operating instructions are the same, in this 
manual they are both referred to simply as the graphics 
tablet, or just the tablet. 


Both tablets include: 
@ The tablet (with cables connected to it) 
@ The input devices (one or more of the following): 
e Astylus (standard) 
e A one-button cursor (optional) 
e A four-button cursor (optional) 
@ A bar magnet for restoring the tablet’s bias 
@ A precision grid (optional) 
This manual assumes that the hardware for the tablet is 
installed and that it is ready for use. If that is not the case, a 
qualified technician should follow the installation instruc- 


tions included in the 4//0 Series F13/14 Graphics Tablet 
Instruction Manual. 


TO HARD COPY 
CONNECTOR 


4665-30 


Figure 3-8. TO HARD COPY Connector. 
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Table 3-9 lists the terminal’s setup commands that deal 
specifically with the operation of the tablet. See Section 6 


for more details. 


Table 3-9 
TABLET SETUP COMMANDS 

Command Explanation 

TBFILTER Specifies the time and distance filtering 
the tablet is to use for strokes in 
Graphics Input mode. 

TBHEADERCHARS | Specifies the header characters used by 
the tablet when it sends data to the host 
program. 

TBSTATUS Specifies how the tablet emulates the 
TEKTRONIX 4953 or 4954 Graphics 
Tablet. 

TBSIZE Specifies active area size of the tablet. 
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ATTACHING THE TABLET 


Figure 3-9 illustrates where to plug the cables into the 
graphics tablet interface. The cable from the input device 
(stylus, one-button, or four-button cursor) goes into the top 
connector in the interface; the cable from the upper-left 
corner of the tablet goes to the middle connector; and the 
cable from the lower-right corner goes to the bottom con- 
nector. 


It is important to plug the correct cable into the correct out- 
let. If they are crossed, the tablet will not function properly. 


“STYLUS J3003 


UPPER LEFT 
CORNER J3004 TABLET INTERFACE 


CONNECTOR 





TABLET INTERFACE 


Figure 3-9. Tablet Interface Connector. 
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THE STYLUS 


There are two different kinds of fillers for the stylus. One is a 
ballpoint filler; the other filler is a blank, which doesn’t draw 

lines. You can use either of these fillers, depending on your 

needs. 


To change a filler, unscrew the bottom part of the stylus just 
as you would a ballpoint pen. Gently pull the filler straight 
down. Be careful not to break either of the two probes 
(Figure 3-10). Insert the other filler and screw the stylus 
back together. 


POSITIONING THE PRECISION GRID 


The precision grid is an optional accessory to the graphics 
tablet. If you have one, the grid can be used to help you 
enter data more precisely. 


The procedure for positioning the grid on the tablet is 
included in the 4/10 Series F13/14 Graphics Tablet Instruc- 


tion Manual. 


CLEANING THE TABLET SURFACE 


Clean the tablet as often as necessary, using a damp cloth 
and mild detergent such as window or glass cleaner. Do not 
immerse the tablet in water or get it too wet. Never use a 
cleaner that contains hydrocarbons, since they will dissolve 
the tablet surface. 





Figure 3-10. Taking the Stylus Apart. 
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ISI 


CAUTION } 


IL —I.L ISD 2 I~ 


Keep the tablet biasing magnet away from the 
terminal. Internal magnetic fields may change, 
requiring readjustment. Also keep magnetic tapes, 
Jlexible disks, and other magnetically sensitive 
items away from the tablet surface. 


RESTORING THE TABLET BIAS 


About once a week, you should use the following procedure 
to restore the tablet’s magnetic bias. Use this procedure 
more often if the tablet begins to relay incorrect data or if the 
graphics cursor moves erratically. 


1. Turn the terminal off and unplug it. 
2. Disconnect the tablet from the interface. 


3. Pull the magnet across the tablet from the upper-left 
corner towards the lower-right corner in a single, 
smooth motion (Figure 3-11). Wipe the entire surface in 
about two or three seconds. 


4. Reconnect the tablet, plug the terminal back in, and 
turn it on. 


Store the magnet away from the tablet and other magneti- 
cally sensitive items (such as flexible disks and magnetic 
tapes). 


Figure 3-11. Restoring the Tablet Bias. 
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Section 4 


GRAPHICS INPUT MODE 


OVERVIEW OF GIN MODE 


Graphics Input (GIN) mode allows you to send graphics 
information to a host program. This section includes an 
explanation of how to position the graphics cursor with each 
input device and how to use each of the GIN functions. 


Usually a host resident program will put the terminal into 
GIN mode and prompt you for certain information. You can 
use escape sequence commands in Setup mode to put the 
terminal in GIN mode. For detailed information on the GIN 
functions see the 4/10 Series Host Programmers Manual. 


The host resident program should also prompt you concern- 
ing what kind of data you should enter. For example, it might 
tell you to /ocate a certain number of points on the screen 
(the locate function), to pick acertain menu item or part of 
the picture (the picking function), or to stroke (draw) some- 
thing on the screen (the rubberbanding and inking 
functions). 


The devices that you can use to locate and send graphics 
information to a program are: 

@ The terminal’s thumbwheels 

@ Agraphics tablet 

@ A 4662 or 4663 Plotter 

An explanation of how to position the graphics cursor with 


each input device and how to use each of the functions is 
included in this section. 


Appendix F shows examples of GIN operations. 


THE PICK FUNCTION 


When graphic information is stored in segments, a pick 
function allows you to select items or actions by positioning 
the GIN cursor. 
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A program might be written so you are asked to choose 
between several actions. This list of actions is called the 
menu. The program would instruct you to pick the desired 
action. To do so, position the graphics cursor on or near the 
description of the appropriate action. The way you signal 
the program that the cursor is at the position you want to 
pick depends on the input device you are using. These 
methods are described later in this section. 


You might also be asked to pick a part of the picture to be 
moved, enlarged, reoriented, or changed in some way. 
Again, you would position the graphics cursor on or near the 
object and signal the program that the cursor is at the loca- 
tion you want to pick. 


THE LOCATE FUNCTION 


You can /ocate a particular point on the display by moving 
the graphics cursor to the appropriate point on the screen. 
When it is properly located, signal the program that you 
have located the cursor. The input device sends the coordi- 
nates of that point to the program. 


INKING 


As you locate points on the screen, you can draw lines 
between these points by using the inking function. Inking is 
activated by an escape sequence command (see Appendix 
C) or by the GININKING setup command. 


RUBBERBANDING 


When you move the cursor, you can have a line “follow” the 
graphics cursor. One end of the line is anchored at the last 
point and the other end of the line is attached to the graph- 
ics cursor. This is called rubberbanding. Rubberbanding is 
activated by an escape sequence command (see Appendix 
C) or by the GINGRIDDING setup command. Both inking 
and rubberbanding can be active at the same time. 
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GRAPHICS INPUT MODE 


GRIDDING 


A program can also specify that an invisible grid be in effect 
on the screen. When a grid is active, you can only locate the 
cursor on points where the vertical and horizontal lines of 
the grid intersect. This allows you to precisely position the 
cursor when it is necessary to draw lines that intersect at a 
90° angle. When you move the graphics cursor, it may 
jump from one point to the next. If this happens, you will 
know that gridding is probably in effect and the cursor is 
moving between points on the grid. 


The setup command, GINGRIDDING, allows you to easily 
establish a grid for the input device. See Section 6. 


THE STROKE FUNCTION 


The graphics tablet allows you to draw lines as you move 
the stylus along the surface of the tablet. (The terminal 
draws lines between points when it is using inking, but the 
lines appear only on the screen; they are not saved.) The 
coordinates of the points can be sent to the host. The host 
can store these coordinates for further processing or send 
them back to the terminal for display or storage in 
segments. 


USING THE TERMINAL’S 
THUMBWHEELS 


When the terminal is in GIN mode, a graphics cursor 
appears on the screen. The default is the crosshair cursor 
(Figure 4-1). However, the program can select another user- 
defined segment to be the graphics cursor. 


Position the graphics cursor with the thumbwheels 

(Figure 4-2). As the arrows on the keyboard indicate, the top 
thumbwheel moves the graphics cursor up and down and 
the bottom thumbwheel moves it back and forth across the 
screen. 


The cursor moves more slowly if you hold down the Shift 
key as you rotate a thumbwheel. This allows you to position 
the cursor more precisely. This is an example of vernier 
action (see Section 2). 
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When you have positioned the graphics cursor where you 
want it, send the location of that point to the program by 
pressing any alphanumeric key. When you press the key, 
the crosshair cursor blinks momentarily as the point is 
transmitted to the program. Do not press the Rtn key, as that 
Causes invalid data to be transmitted. 
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Figure 4-1. The Crosshair Cursor. 
Figure 4-2. The Thumbwheels. 
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USING THE TABLET 


When you use a graphics tablet for a GIN device, the graph- 
ics cursor will be visible on the screen. The crosshair cursor 
(Figure 4-1) is the default graphics cursor, but the program 
can select any segment as the cursor. The applications 
program should inform you as to what the graphics cursor 
is, if itis not evident. 


When the tablet is active, you can use one of three input 
devices: the stylus, a single-button cursor, or a four-button 
cursor (Figure 4-3). 


You can locate points inan11 x 11” square on the smaller 
tablet (Option 13) anda 30 x 40” area on the larger tablet 
(Option 14). This is called the active writing area. \n both 
cases, the center of the active writing area is the center of 
the tablet. 


TABLET 


GRAPHICS INPUT MODE 


THE STYLUS AND 
THE ONE-BUTTON CURSOR 


The Stylus 


Hold the stylus as you would a ballpoint pen, with the tip 
resting on the tablet. The crosshair cursor on the terminal 
screen tracks the stylus as you move it. The tablet can keep 
track of the stylus as long as it is within 5/32 of an inch of the 
tablet surface. Press down on the stylus to send the point’s 
location to the computer. The stylus’s tip moves slightly and 
the graphics cursor blinks momentarily as the point is trans- 
mitted to the applications program. 


The One-Button Cursor 


To use the one-button cursor, lay the cursor flat on the tablet 
surface with the button facing up. As you move the cursor 
along the surface of the tablet, the graphics cursor follows it 
across the screen. When you use the pick and locate func- 
tions, locate the appropriate point on the tablet or terminal 
display and press down on the button. 


STYLUS 





PRECISION 
GRID 


1-BUTTON 
CURSOR 


4-BUTTON 
CURSOR 
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Figure 4-3. The Option 13 Graphic Tablet. 


4115B OPERATORS 


4-3 


GRAPHICS INPUT MODE 


For the stroke function, hold down the stylus or cursor but- 
ton and move the stylus or cursor across the tablet surface 
as if you were drawing on it. The number of points transmit- 
ted to the program depends on the setting of the TBFILTER 
command (see Section 6). 


The Four-Button Cursor 


Lay the cursor flat on the tablet surface with the buttons 
facing up. As you move it along the surface of the tablet, the 
cursor tracks it. 


The functions of the four buttons can be defined by the 
applications program. For example, one button might cause 
inking to be used, another button might erase the line 
between the next two points, the third could implement the 
stroke function, and so on. The applications program should 
inform you how to use the buttons. 


If the buttons are not programmed, you can press any of the 


four buttons to transmit the current location of the graphics 
cursor to the applications program. 
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USING THE 4662 OR 
4663 PLOTTER IN GIN MODE 


Use the plotter’s joystick to position the pen at the appropri- 
ate location. If you are using a 4662 to indicate to the pro- 
gram that you have located the point you want, press the 
plotter’s CALL button until the plotter beeps one time, then 
release it. If you are using a 4663, press the plotter's DRAW 
POINT button when you locate the point you want. 


For additional operating instructions, see the 4662 or 4663 
Operators Manual. 


NOTE 


When using a plotter for graphic input, the cursor 
image on the terminal’s screen does not continu- 
ously follow the plotter’s pen. The graphic cursor 
image on the terminal’s screen is updated once for 
every GIN event. 
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Section 5 


HOST COMMUNICATIONS OVERVIEW 


This section provides an overview of the concepts involved 
in communications between the terminal and a host com- 


Table 5-1 lists all setup commands that set host communica- 
tions parameters. The commands under the heading Stand- 


puter. Most communications parameters are set by the host 
— either by a system-level program or an applications pro- 
gram. However, some parameters must be set correctly 
from the keyboard or a disk file before any communications 
at all can occur. For example, if the host and the terminal 
have conflicting baud rates (data transmission rates), com- 
munications will be garbled. In a similar fashion, if the host 
checks for even parity and the terminal transmits odd parity, 
communications problems will occur. 


Therefore, it is important for the operator to understand the 


ard Commands are standard for the terminal. The com- 
mands under the heading Optional Commands are part of 
the Extended Communications Interface (Option 01). 


Many of the concepts discussed here also apply to com- 
munications with other devices. In fact, several setup com- 
mands that begin with the letter P set parameters for com- 
munications through the 3PPI (Option 10) — PBAUD, 
PBITS, etc. For details on all communications concepts and 
commands, refer to the 47/0 Series Host Programmers 
Manual, your host system manuals, or your system 


basic communications concepts to avoid these problems programmer. 
and to correct them promptly if they occur. The rest of this 
section discusses the basic concepts that you need to moni- 
tor and correct such problems. 
Table 5-1 


PROMPTSTRING 


COMMUNICATIONS COMMANDS 


Standard 
Commands Explanation 
BAUDRATE Specifies transmit and receive baud rates. 
BREAKTIME Specifies length of break transmission. 
BYPASSCANCEL Specifies bypass cancel character. 
EOFSTRING Specifies end-of-file string. 
EOLSTRING Specifies end-of-line string. 

~ EOMCHARS Specifies end-of-message characters. 
FLAGGING Specifies whether flagging is used and what 

kind. 

PARITY Specifies how parity is checked. 
PROMPTMODE Specifies whether or not terminal is in 


Prompt mode. 


Specifies prompt string. 


QUEUESIZE Specifies size of terminal’s input queue. 

STOPBITS Specifies number of stop bits used. 

XMTDELAY Specifies time terminal waits after 
transmitting an end-of-message character 
before resuming transmission. 

XMTLIMIT Sets upper-limit of terminal’s transmission 
rate. 
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Optional 

Commands Explanation 

BCONTINUECHARS | Specifies block-continue characters. 
BENDCHARS Specifies block-end characters. 
BHEADERS Specifies block-header sequences. 
BLENGTH Specifies block length. 


BLINELENGTH 


Specifies maximum line length for Block 
mode. 


BLOCKMODE Specifies Block mode. 

BMASTERCHARS Specifies block-master characters. 

BNONXMTCHARS Specifies block non-transmittable 
characters. 

BPACKING Specifies manner in which blocks are 
packed for transmission and receiving. 

BTIMEOUT Specifies how long terminal waits before 
retransmitting previous block. 

DUPLEX Specifies Duplex mode. 
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HOST COMMUNICATIONS OVERVIEW 


STANDARD COMMUNICATIONS 


The terminal’s standard communications feature all facili- 
ties necessary to support I/O with most host computers. 
These include: 


@ Full duplex 
@ RS-232-C compatibility 
@ Prompt mode 


® Flagging 


Full duplex implies that the terminal can send and receive 
data at the same time. Whether this actually occurs 
depends on whether the host is capable of sending and 
receiving data simultaneously. 


Prompt mode, flagging, and half duplex are explained later 
in this section. 


COMMUNICATIONS CONCEPTS 


The following text explains concepts and terminology that 
apply to standard communications commands. They also 
apply to communications in Block mode and Half Duplex 
mode. 


Baud Rate 


The baud rate is the rate at which data is transmitted 
between the host and the terminal. As used in this manual, 
the term baud rate means “bits per second.” Transmission 
at a rate of 9600 baud means 9600 bits per second, or 
approximately 960 characters per second. 


The factory default baud rate is 2400. You can use the setup 
command BAUDRATE to modify it. The transmit and 
receive baud rates can be set independently. 


The terminal must be set to communicate at the same baud 
rates as the host. If not, data will be misinterpreted or not 
communicated at all. You can use the STATUS command to 
determine the terminal’s current transmit and receive baud 
rates. 


Parity 


Parity checking is one way to verify the accuracy of data 
transmission on a character-by-character basis. Each char- 
acter is coded into eight bits (binary digits). The first seven 
bits define the character itself. The eighth bit is used asa 
parity bit; the word parity refers to whether the sum of digits 
in the character is even or odd. 


There are several schemes for parity checking. For exam- 
ple, the parity bit may be set so that the total number of ones 
in the character is even. This is called even parity. Asa 
character is received by the host, the sum of its bits is calcu- 
lated; if this sum is odd, the host knows that an error in 
transmitting the character has occurred. Odd parity works 
the same way, except that the parity bit is set so that the 
sum of all bits in the character is odd. 


Other common parity schemes are high (parity bit is always 
set to one), none (parity bit is always set to zero), and data 
(parity bit is used as part of the data and no parity checking 
is performed). 


The method of setting the parity bit in characters transmit- 
ted to the host is determined by the PARITY command. This 
parity must be set to match what the host expects; other- 
wise the host will detect errors in transmission when there 
are none, and communications will be disrupted. 


Flagging 


It may be necessary for the terminal and the host to inform 
each other when each is ready to receive data and when 
transmission should be temporarily suspended. 


The terminal has an input queue into which data is collected 
until it can be processed. When the input queue is full, the 
terminal can send a character (called a flag) to stop data 
transmission from the host. Any additional data that the host 
tries to send to the terminal is lost. When there is more room 
in the queue, another flag is sent to tell the host to resume 
transmission. 


This is not used on all hosts. Some hosts require different 
kinds of flagging. The setup command FLAGGING allows 
the operator or programmer to define the flagging 
parameters. 
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Queue Size 


When the terminal receives data from the host computer, it 
stores this in an input queue — an internal data buffer — 
until this data can be processed. The QUEUESIZE com- 
mand specifies the size of the queue. Its size depends on 
the host computer, the rate of transmission, the kind of 
communications link used, and other installation-dependent 
factors. The factory default queue size is 300 bytes. 


XMT Limit 


Sometimes the rate at which a host computer can effec- 
tively receive data is less than the maximum baud rate 
specified for the communications port. 


For example, a time-share host servicing many users may 
not be able to receive data at 9600 baud, even though you 
are logged onto a 9600 baud port. In such a case, you could 
leave the terminal’s transmit baud rate setting at 9600, but 
set the transmit-limit parameter (established by the 
XMTLIMIT commana) to a level with which the host can 
cope — perhaps 8000. The terminal then sees to it that data 
is not transmitted at a rate faster than 8000 baud. 


The baud rate is not actually changed, but the characters 
transmitted are spaced so that the number transmitted per 
second is the same as if the baud rate were the transmit 
limit rate. 


The factory default transmit limit is 19200 baud. If your host 
can receive data at speeds up to 19200 baud, you do not 
have to be concerned with the transmit limit. Check with 
your programmer to find out. 


Break Time 


There will be occasions when you need to interrupt the 
transmission of data from the host or halt a host program. 
One way to do so is to press the Break key. 


The Break key sends an interrupt transmission to the host. 
The length of the interrupt is set by a command called 
BREAKTIME. The factory default BREAKTIME parameter is 
set to 200 ms. However, it may need to be longer or shorter; 
on some hosts, you may not want to use the Break key at all. 
In that case, BREAKTIME can be set to O ms. 
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EOL String 


The EOLSTRING command (see Section 6) is used to 
change the end-of-line string. The end-of-line string indi- 
cates the end of the transmission of a line of data. It is sent 
by the terminal at the end of (or during) transmissions gen- 
erated by the terminal. 


The factory default end-of-line string is the carriage return 
(Cr). This works for all hosts that interpret the carriage return 
as the end of a particular line of data. 


Since you explicitly inform the host of the end of a line by 
typing a rn when entering data from the keyboard, no 
special action must be taken by the terminal. 


Sometimes the host requests information from the terminal 
that is sent in a different format and requires no operator 
interaction. The program may request a report of error 
messages, for example, or some graphics input data. In 
such cases, the terminal sends an end-of-line character to 
the host to indicate the end of a transmission. 


XMT Delay 


In some cases a part of the data transmission system — 
perhaps a modem — requires a little time to change from a 
transmit state to a receive state or vice versa. This delay is 
called the turnaround time, since it is the time needed to 
reverse the direction of data transmission. To accommodate 
such turnaround delays, the terminal can be set to wait a 
certain length of time after it receives a host transmission 
before transmitting data back. 


This transmit delay is set with the XMTDELAY command. 
The transmit delay can be set from 0 to 65535 ms (about 
one minute). Turnaround times, if required, are typically 
about 50 to 100 ms. Consult with your host system program- 
mer to find out if a transmit delay is required, and if so, how 
long the delay must be. 


EOF String 


When files are transferred between the host and terminal, it 
is necessary to know when the file transfer is complete. This 
is indicated by an end-of-/file string of from one to ten ASCII 
characters. 
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When a data file is transferred from the host to the terminal 
using a COPY or SPOOL command, the host must send the 
end-of-file string when it reaches the end of the file. The 
terminal sends the same string to the host when it reaches 
the end of a file it is transferring to the host. 


The terminal’s end-of-file string is defined by the EOF- 
STRING command. It should be set to whatever the host 
computer sends when it reaches the end of a file. It is best 
to set this to the null string except when you are actually 
transmitting files, since the string is ignored by the terminal 
whenever it is detected in a host transmission. 


Stop Bits 


Each character sent between the host and terminal is coded 
into eight binary digits (bits) of data. Each of these eight-bit 
codes Is called a byte. 


After sending a byte of data, the host or terminal sends 
either one or two extra bits to indicate the end of a byte. 
These extra bits are called stop bits 


The terminal includes a STOPBITS command, which allows 
you to specify whether the terminal sends one or two stop 
bits at the end of each byte. The factory default is 1. 


EOM Characters 


The end-of-message characters are used during communi- 
cations turnaround between the terminal and the host. 


When the terminal is transmitting to the host and it encoun- 
ters an end-of-message character, it transmits that charac- 
ter and then pauses for a period of time before resuming 
transmission. 


If the terminal is in Prompt mode, when it sees the end-of- 
message character it knows to wait for a prompt string from 
the host before resuming transmission. When the terminal 
is in Block mode, it first transmits the block, then waits for 
the time specified by XMTDELAY and then waits for the next 
prompt. The period of time the terminal waits is specified by 
the XMTDELAY command 
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The end-of-message characters are set by the EOMCHARS 
command. The factory default characters are CARRIAGE 
RETURN and NUL. Since NUL Is ignored by the terminal, 
setting both end-of-message characters to NUL disables 
this feature. 


Bypass Cancel Character 


There are many characters that are transmitted between 
the host and the terminal that you do not want to see. For 
example, graphics input characters and other report char- 
acters are not important to an operator, yet they must be 
processed by the terminal. 


Instead of being displayed, these characters are automati- 
cally bypassed. The bypass cancel character is used by the 
4110 Series terminals to assure that the correct characters 
are bypassed and that the display of characters is resumed. 


This character is specified by the BYPASSCANCEL com- 
mand. The factory default is the line feed character. 


PROMPT MODE 


Prompt mode is one way of managing communications 
between the terminal and the host computer. In Prompt 
mode, data to be sent to the host is stored in an output 
queue. When a predefined string of characters — calleda 
prompt string — is received from the host (and the transmit 
delay satisfied), the terminal sends data from the output 
queue until it sees the end-of-message character. After it 
sends the end-of-message character, the terminal halts 
transmission until it receives another prompt string from the 
host. This allows the host to decide when it is ready for more 
data from the terminal. 


The PROMPTMODE command can be used to enter or exit 

Prompt mode. The PROMPTSTRING command specifies a 

string of one to ten ASCII characters that the terminal recog- 
nizes as the prompt string. This string must match the string 
sent by the host. 


All of the standard communications commands (see Table 
5-1) remain valid in Prompt mode. 
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BLOCK MODE 


In Block mode (available with Option 01) data is packed into 
blocks and each block transmitted as a burst of data. After 
each block is transmitted, there must be a response from 
the device that received it before another block is sent. This 
process verifies the accuracy of the transmission of each 
block. If there were any errors in the transmission, the same 
block is retransmitted until it arrives in a correct form. 


Because of this format, Block mode allows easier transmis- 
sion of full ASCII or binary code. It also provides error detec- 
tion and automatic retransmission of bad data blocks. 


Block mode can be used at the same time as Prompt mode 
and in Full Duplex or Half Duplex mode. 


Specific details concerning how Block mode works are 
rather involved. The 4110 Series Host Programmers Manual 
contains more information on Block mode. 


The BLOCKMODE command arms (prepares) the terminal 
for entering Block mode. The terminal actually enters Block 
mode when it receives the first block header sequence. 


The following command definitions are an introduction to 
the concepts of Block mode communications. They are 
included because there are setup commands that specify 
these parameters. The syntax of each Block mode com- 
munications command is detailed in Section 6. 


BLENGTH 


The BLENGTH command specifies the maximum length of 
each block for both transmitting and receiving. The factory 
default block length is 256 bytes (characters). 


The best size for a block length depends on several factors. 
After each block is transmitted by either the terminal or the 
host, a response is required before the next block is sent. 
The shorter the block, the more time is spent responding to 
blocks sent and received. For a long block, more time is 
spent retransmitting a block if retransmitting is necessary. 
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BHEADERS 


The start of each line of data in Block mode is indicated by a 
header sequence. The header sequence is a string of from 
one to ten ASCII characters. The first character in the 
sequence cannot be used elsewhere in the sequence; and 
the sequence cannot include any character that is part of 
the prompt string. 


The BHEADERS command specifies the header sequence. 
The factory defaults are HEADTX and HEADRX. 


BCONTINUECHARS 


A block of data may be one or more lines long. If a block 
extends to more than one line, each line ends with a block- 
continue character, indicating that more lines follow. There 
can be different block-continue characters for transmitting 
and receiving. 


The BCONTINUECHARS command specifies the block- 
continue characters. The choice of characters depends on 
which characters the host expects. The factory default 
block-continue character for both transmit and receive is the 
ampersand (&). 


BENDCHARS 


The BENDCHARS command specifies the end of a block. 
The block-end character must be compatible with the host 
software. 


BLINELENGTH 


The BLINELENGTH command sets the block line length in 
characters. The default block line length is 70. There is no 
maximum line length for the terminal, since it can receive a 


line of any length. The block line length should not be set to 


a value that exceeds the input buffer of the host. 
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BPACKING 


There are various data packing schemes available for host 
systems with limited transmission capabilities. That is, if 
your host cannot transmit full 7-bit ASCil or 8-bit binary 
data, the data can be coded (packed) into a reduced charac- 
ter set. 


The BPACKING command specifies the data packing 
scheme. 


BTIMEOUT 


When the terminal sends a block of data, it waits fora 
response from the host to acknowledge that it has received 
that block intact. If the terminal does not receive the appro- 
priate response within the specified period of time, or if it 
receives an erroneous response, the terminal retransmits 
that block. It pauses again, and will repeat the sending of 
the block until it is acknowledged. 


The BTIMEOUT command specifies the period of time the 
terminal waits before sending the block again. Be sure that 
the specified timeout period is longer than may be encoun- 
tered due simply to a busy host. 


BNONXMTCHARS and BMASTERCHARS 


In Block mode, characters that are used for controlling 
block mode (block-continue character, block-end charac- 
ters, etc.) may also appear in text. For example, suppose 
the ampersand (&) is designated as the block-continue 
character. Any occurrence of & in the data transmission will 
be interpreted as the block-continue character. Even though 
characters are chosen for block control that do not often 
occur in text, yet they may occasionally be needed as valid 
text characters. : 
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To allow this, characters used for block mode control that 
may also occur in text are designated as non-transmittable, 
meaning that they cannot be transmitted directly as text 
characters. When a non-transmittable character occurs in 
text, itis encoded as a two-character sequence consisting 
of a master character and a substitute character. When this 
two-character sequence is received, it is then decoded as 
the correct text character. | 


The BMASTERCHARS command sets the master charac- 
ter; the BNONXMTCHARS command specifies the non- 
transmittable characters. The receive master character and 
non-transmittable characters may be different from the 
transmit characters. 


HALF DUPLEX MODE 


In Full Duplex mode, the terminal and host can both send 
and receive data at the same time. The standard mode of 
communication is Full Duplex. This includes when the ter- 
minal is in Prompt mode or Block mode. 


In Half Duplex mode, the terminal and host can send and 
receive data, but not at the same time. All of the standard 
communications commands are meaningful in Half Duplex 
mode. | 


When the terminal is in Half Duplex mode with Supervisor 
Communications mode, the host always controls the flow of 
data; that is, the host decides when the terminal or host 
sends or receives data. 
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SETUP COMMANDS 


Setup commands allow you to establish the terminal’s oper- 
ating environment and to use peripherals attached to the 
terminal. For example, setup commands are used to set 
communications rates, inquire about the terminal’s status, 
determine what level of errors should be displayed, confi- 
gure communications ports for the needs of particular 
peripheral devices, and program special meanings 
(macros) into keys. 


The terminal must be in Setup mode to execute setup com- 
mands. Only the operator can place the terminal in Setup 
mode or remove it from Setup mode. To place the terminal 


in Setup mode, press the SET UP key (Figure 6-1). The red 
light in the key glows to show that the terminal has entered 
Setup mode. To remove the terminal from Setup mode, just 
press the SET UP key again; the light in the key goes off to 
show that Setup mode has been terminated. 


This section contains an explanation of Setup mode and 
description of each English-style setup command. Table 6-1 
summarizes the setup commands by functional groups. The 
Command Dictionary part of the section describes each 
setup command in detail, with commands listed in alphabet- 
ical order. 


SET UP 
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Figure 6-1. The SET UP Key. 
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SETUP COMMANDS 


SETUP MODE 


Setup mode interacts with other terminal modes and func- 
tions in various ways. 


Host Communications. Communication to the host com- 
puter is suspended when the terminal is in Setup mode. 
Data sent from the host is stored in an input queue and 
processed when the terminal leaves Setup mode. (The size 
of this queue is set by the QUEVESIZE commana.) 


GIN Mode. When the terminal enters Setup mode, GIN 
mode is suspended. The GIN cursor disappears and 
graphic input is not processed. When the terminal leaves 
Setup mode, the cursor reappears and GIN mode con- 
tinues. See the 4/10 Series Host Programmers Manual and 
the 4110 Series Command Reference Manual for details on 
GIN mode. 


Control Characters. In Setup mode, most control charac- 
ters are displayed rather than executed. Control characters 
are displayed as two-character snoopy characters; for exam- 
ple, the Escape character is displayed as c. 


Programmed Keys. If the terminal is in Setup mode and 
you press a key that has a macro programmed into it, the 
macro is expanded as usual. (See the DEFINE command 
description later in this section.) 


Local Mode. When the lights in both the SET UP and 
LOCAL keys are on, both Setup and Local modes are set. 


Data is echoed locally only, instead of being sent to the host. 


ESCAPE SEQUENCE COMMANDS 


In this manual, the term setup command refers only to the 
English-style commands documented in this section. Only 
those commands that are most useful to a typical operator 
have English-style setup names. The terminal also 
responds to escape sequence commands, whether it is in 
Setup mode or not. These commands include equivalents 
for all of the English-style setup commands (in a different 
command format), as well as a large number of other com- 
mands to control the terminal. 
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Each escape sequence command begins with the ASCII 
Escape character ©c, followed by a two-character op-code. 
The command may include one or more parameters that 
define the exact action of the command. Appendix C con- 
tains a list of allescape sequence commands. The 4/10 
Series Command Reference Manual contains detailed 
descriptions of all such commands. 


SETUP MEMORY 


The terminal stores many setup command parameters in 
setup memory. When the terminal is turned on, it remem- 
bers these parameters. This saves you the trouble of reset- 
ting basic operating parameters each time you turn on the 
terminal. 


The STATUS command will display one, some, or all of the 
setup command parameters. See the STATUS command 
description later in this section. (STATUS also works with 
escape sequence commands.) 


Table 6-1 lists all setup commands by functional groups. 
Included is the command name, the factory default settings 
of the parameters set by the command, and a brief descrip- 
tion of the purpose of the command. A superscript (*) follow- 
ing acommand name indicates that the parameters set by 
the command are stored in setup memory and remembered 
when the terminal is turned off and back on again. In the 
command dictionary portion of this section, the notation 
(Memory) after the command purpose indicates the same 
thing. 


SETUP COMMAND SUMMARY 


Table 6-1 lists and briefly describes all setup commands. It 
also indicates the factory default parameter values, which 
commands are part of options to the terminal, and those 
commands whose parameters are stored in setup memory. 
The factory default is shown for each parameter because 
that is the value the terminal assumes if the setup memory 
fails or is changed by the addition or deletion of a circuit 
board. 
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Function 


General Terminal 
Operation 


Dialog Area 
Control 
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Table 6-1 
SETUP COMMANDS 


CMAP See Table 6-2 


CMODE 31 1 (See Table 6-3) 
CODE TEK 


CRLF? NO 
DEFINE 
ECHO? NO 

RUBOUT, °n, ~ 


No default 


EDITCHARS 


ERRORLEVEL 
FIXUP 


GAMODE? REPLACE 


IGNOREDEL? 


KEYEXCHAR? 
LFCR? 
LOCKKEYBOARD 


PAGEFULL? NONE 


RENEW No default 


REOM? 1 


RLINELENGTH 0 
SNOOPY NO 
STATUS No default 


DABUFFER? 
DACHARS? 


DAENABLE# 


DAINDEX? 

DA2INDEX? 

DALINES? 

DAMODE? REPLACE 
DAPOSITION? 0,0 
DASURFACE? 1 

DAVIS? NO 
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Determines mapping from a surface’s color indices to 
particular color mixtures. 


Sets the color mode parameters. 


Selects the command syntax to which the terminal will 
respond. 


Sets or terminates “carriage return implies line feed.” 
Assigns macro to key or integer. 
Sets local or remote echo. 


Defines character delete, line edit, and literal 
characters. 


Sets error reporting threshold. 


Determines how thoroughly the viewport is updated 
when a change is made that affects it. 


Determines if background of character is visible when 
text is displayed in graphics area. 


Specifies whether or not the ASCII delete character is 
ignored. 


Specifies the key execute toggle character. 
Sets or terminates “line feed implies carriage return.” 
Locks the keyboard. 


Determines action to be taken when pagefull condition 
occurs. 


Erases view and redraws all visible segments. 


Determines use of end-of-message character for GIN 
mode. 


Determines GIN report line length limit. 
Sets or terminates snoopy mode. 


Displays the terminal’s status. 


Sets maximum size of dialog buffer in lines. 


Sets maximum number of characters per line in the 
dialog area. 


Specifies whether or not alpha text is sent to the dialog 
area. 


Specifies the display colors in the dialog area. 
Specifies the color to use for Graphic Rendition 1. 
Specifies the visible portion of the dialog buffer. 
Sets Overwrite or Replace mode in dialog area. 
Sets position of dialog area. 

Sets dialog area surface. 


Sets visibility of the dialog area. 
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Function 


File Transfer 
Control 


Graphic Input 
(GIN) 


Standard 
Communications 


GINAREA 


GINCURSOR 
GINDISABLE 
GINENABLE 


GINGRIDDING 
GININKING 
GINPICKAPERTURE 


GINRUBBERBAND 
GINSTARTPOINT 
GINWINDOW 


RSIGCHARS 


BAUDRATE? 
BREAKTIME? 
BYPASSCANCEL? 
EOFSTRING? 
EOLSTRING? 
EOMCHARS? 
FLAGGING? 
PARITY ? 
PROMPTMODE 
PROMPTSTRING# 


QUEUESIZE? 
STOPBITS? 
XMTDELAY # 


XMTLIMIT # 


Table 6-1 (cont) 
SETUP COMMANDS 


No default 
No default 
No default 
No default 


No default 


No default 


No Default 
No default 
No default 


No default 
No Default 
8 

No default 


No default 


0,0 
4095, 4095 


No default 


2400, 2400 


Le 


| '’ (empty string) 


Crs 


Cal, 
NONE 

NONE 

NO 

"(empty string) 


300 
1 





Explanation Factory Default Purpose 


Copies data from one device to another. 
Reads a file and executes it as a command file. 
Saves macro, segment, or pixels to a disk file. 


Copies data from one device to another, leaving the 
terminal free to do other jobs at the same time. 


Halts the spooling operation. 


Maps an area ona GIN device to a specified screen 
area. 


Selects a segment to use as the GIN cursor. 


Disables a specified GIN combination. 


Enables GIN mode for a specified device and number of 


GIN events. 

Establishes a grid for GIN input. 

Turns inking on or off. 

Specifies tolerance for picking objects. 


Turns rubberbanding on or off. 


Specifies starting point for inking and rubberbanding. 


Sets a window in terminal space for GINAREA. 


Assigns signature characters for GIN reports. 


Sets transmit and receive baud rates. 

Defines length of break transmission in milliseconds. 
Sets bypass cancel character. 

Defines end-of-file string. 

Defines end-of-line string. 

Defines end-of-message characters. 

Specifies kind of flagging done by the terminal. 
Specifies the kind of parity sent from the terminal. 
Specifies whether or not the terminal is in Prompt mode. 


Specifies prompt used when terminal is in Prompt 
mode. 


Sets size of terminal input queue. 
Specifies number of stop bits the terminal uses. 


Specifies length of time terminal waits after receiving 
end-of-message character. 


Specifies maximum transmit rate for the terminal. 
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Function 


Optional 
Communications 
(Option 01) 


Three Port 
Peripheral 
Interface Control 
(If Option 10 is 
installed, all three 
ports are the same 
on CMOS reset.) 


Graphic Tablet 
(Options 13 and 14) 
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SETUP COMMANDS 


Explanation Factory Default Purpose 


BCONTINUECHARS? & & 
BENDCHARS? $$ 


BHEADERS? ‘HEADTX’ 
'‘HEADRX’ 


BLENGTH? 256 256 
BLINELENGTH? 70 
BLOCKMODE? No 


BMASTERCHARS? # # 
BNONXMTCHARS? 

BPACKING? 

BTIMEOUT # 


DUPLEX?# 


PASSIGN? PPORT 
PBAUD# 2400 
PBITS? 18 
PCOPY No default 
PLOT No default 
PEOF? 
PEOL? 
PFLAG? 
PMAP 
STATUS 3PPI 
PPARITY @ 


’’ (empty string) 


| ‘’ (empty string) 
NONE 
No default 


No default 
NONE 


TBFILTER No default 
TBHEADERCHARS LETTERS 
TBSIZE AUTOMATIC 


TBSTATUS IN 





Specifies block-continue characters. 
Specifies end-of-block characters. 


Specifies block-header sequences. 


Specifies block length. 
Specifies line length for Block mode transmission. 


Specifies whether or not terminal is armed for Block 
mode. 


Specifies master characters for Block mode. 
Specifies nontransmittable characters for Block mode. 
Specifies manner in which blocks are packed. 


Specifies how long terminal waits before retransmitting 
previous block of data. 


Specifies which Duplex mode the terminal is in. 


Assigns a device to a port. 

Sets baud rate for a port. 

Sets the stop and data bits for a port. 

Copies between peripheral devices and the host. 
Plots currently visible segments to specified device. 
Defines the end-of-file string for a port. 

Defines the end-of-line string for a port. 

Establishes type of flagging for a port. 

Assigns a color index to a plotter pen. 

Returns status on peripheral ports. 


Establishes the parity checking used on a port. 


Specifies tablet data filtering. 
Specifies tablet stroke header characters. 
Selects size of active area on tablet. 


Specifies if status byte is sent when input device is lifted 
from tablet surface. 
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SETUP COMMANDS 


Function 


Disk Control 
(Options 42, 43, and 45) 


Color Copier Interface 
(Option 09) 


Local Programmability 
(Option 42,43) 


Table 6-1 (cont) 


SETUP COMMANDS 


No default 
No default 
No default 
No default 


DELETE 
DIRECTORY 
DISMOUNT 
FORMAT 


PROTECT No default 


No default 
No default 


RENAME 
USERNUMBER 


HCCOPIES 


HCDATARES? 


MONO 


HCINTERFACE® 


HCORIENT @ HORIZONTAL 





LPOS No default 


Deletes a file from the disk. 

Displays a directory of the disk. 

Tells the terminal that a disk has been replaced. 
Prepares a disk so files can be created on it. 


Prevents the terminal from writing to a specified disk 
file. 


Renames a disk file. 


Sets a user number for file access. 


Sets number of color hard copies made by each 
harcopy request. 


Sets either one- or two-byte resolution for color hard 
Copy. 


Selects either monochrome or color hardcopy interface 
for subsequent hardcopies. 


Sets image orientation on color hardcopy media. 


Activates local programmability. 
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SETUP COMMAND STRUCTURE 


Each English-style setup command begins with a command 
word, includes zero or more parameters, and ends with a 
Carriage Return. 


The command word is a descriptive English-like word that 
tells the terminal which command is being entered. The 
command words have been chosen to remind you of the 
action of the command; for example, SNOOPY controls 
Snoopy mode, BAUDRATE sets the terminal’s baud rates, 
and so on. 


A setup command word can be entered in either upper or 
lower case letters. (NOTE: Upper and lower case are not 
interchangeable in escape sequence commands.) A com- 
mand word can be abbreviated to as few characters as 
necessary to distinguish it from other commands. For exam- 
ple, the DAINDEX command word can be entered as just 
DAI; it cannot be shortened to DA since several other com- 
mands also begin with these characters. 


Most commands include one or more parameters — num- 
bers, characters, or strings that define the exact action of 
the command. For example, to set the rate at which the 
terminal transmits and receives information, enter the 
BAUDRATE command followed by the two rates: 


BAUD 2400 9600 


The “2400” and “9600” are the parameters that define the 
exact action of the BAUDRATE command (here abbreviated 
to BAUD). 


There are eight types of parameters that may be included in 
various commands. 


Integers. An integer is simply a whole number. The range 
for each integer parameter is given in the specific com- 
mand. 


Reals. A real parameter is a decimal number in the range 
from —32767.0 to + 32767.0. 
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Arrays. An array is a sequence of integers or reals. For 
example, the DAINDEX command accepts an array of up to 
three integers, such as DAINDEX 1 3 4. 


Single Characters. You can specify a single character in 
one of three ways: 


@ Press the appropriate key. This works for all printing 
alphanumeric characters. For example, to set the key- 
execute delimiter to + , give the command KEYEXCHAR +. 


@ Enter the ADE (ASCII Decimal Equivalent) of the charac- 
ter. For example, KEYEXCHAR 43 sets the key-execute 
delimiter to + whose ADE is 43. 


Each ADE is a two- or three-digit number. To enter ADEs 
less than 10, precede the digit by a zero. For example, 
08 indicates ADE 8, the Back Space character; 8 indi- 
cates the number 8 (with ADE 56). Refer to the ASCII 
Code Chart appendix. 


@ To enter a control character that is normally executed, 
precede the character by a /iteral character (see the 
EDITCHARS command description). The factory default 
literal character is a ~ (tilde). For example, to enter a 
Carriage Return in a DEFINE command, enter ~r. The 
tilde causes the terminal to display the Carriage Return 
as a two-character Snoopy mnemonic rather than exe- 
cute it. 


Key Specifiers. A key specifier indicates a particular key on 
the terminal keyboard. For alphanumeric keys, just press 
the key or enter the ADE (as you would to enter a single 
character). To specify a function key, use one of the follow- 
ing key specifiers: 


F1—F8 
S1—S8 


Function keys 1 through 8 
Shifted function keys 1 through 8 


NOTE 


BE SURE TO ENTER THE CHARACTERS “F” 
“1” (for example). Pressing the F1 key will simply 
execute the current macro assigned to that key. 
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Keywords. A keyword is just a sequence of alphanumeric 
characters that you enter as shown. Keywords, like com- 
mand words, can be abbreviated. For example, to put the 
terminal in Snoopy mode, enter: SNOOPY YES or just 
SNO Y. 


Undelimited Strings. These are simply strings of ASCII 
characters. They are entered just like keywords. The differ- 
ence is that keywords are predetermined strings that the 
terminal expects to see — like YES or NO. An undelimited 
string can be any string that you choose (subject, of course, 
to the requirements of the particular command). All string 
parameters are undelimited unless otherwise noted. 


Delimited Strings. A delimited string is a string of charac- 
ters that is preceded and followed by the same delimiter. 
The delimiter is a character that tells the terminal where the 
character string begins and ends. The delimiter can be any 
character except a Space, Comma, or one of the Edit char- 
acters (see EDITCHARS). Generally, when the terminal 
expects a delimited string it assumes that the first alphanu- 
meric character that is not a Space, Comma, or Edit charac- 
ter is the delimiter for the string. For example, to program 
the + key to generate the string Hi There!, you could enter 
the following: 


DEFINE + /Hi There!/ 


Here, the ‘‘/” is the delimiter for the string Hi There!. 


A “command line” can be up to 130 characters long. If you 
continue typing past the right margin of the screen, the 
cursor just “wraps around” to the left margin of the next line 
on the screen and the extra characters are displayed on that 
line. The command line continues until you press the Rtn 
key. If you keep typing after the maximum of 130 characters, 
the terminal ignores the extra input and rings the terminal 
bell each time you press a key. This continues until you end 
the command by pressing Rtn or delete some of the input 
(see the Correcting Errors discussion that follows). 


Command Terminator. Each setup command must be 
terminated by a Carriage Return. This terminates the input 
line and causes the terminal to execute the command. This 
terminating Carriage Return is shown in the command 
examples as ©r; for example: 


BAUD 2400 9600°R 
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DEVICE NAMES AND FILE NAMES 


Several commands in this section take device names or file 
names as parameters. These are always undelimited 
strings. Both device names and file names must conform to 
the conditions given under the following headings. 


Device Names 


The terminal has two optional flexible disk drives. Option 42 
includes one drive; Option 43 includes two drives. Both of 
these options include Option 45, the Mass Storage Inter- 
face; Option 45 can also be installed separately. Option 45 
allows the terminal to address several external mass stor- 
age drives. 


Several of the terminal’s commands allow you to access 
one of these as either a source device or a destination 
device, or a file on one of these devices. 


Unless otherwise noted, valid device names are: 


HO: Host communications port. 


FO: Flexible disk drive 0. (Option 42 or 43). This is 
the default drive; if you specify a filename 
without a device name, device FO: is assumed 


F1: Flexible disk drive 1. (Option 43) 

SO: — S7: 

TO: — T7: 

U0: — U7: 

VO:— V7: External mass storage devices (Option 45) 
WO: — W7: 

X0: — X7: 

YO: — Y7: 

20: — 27: 


The default device is FO:. That is, the following two com- 
mands are equivalent: 


COMMAND filename 
COMMAND F0:filename 
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Other device names are included with Option 09 (Color 
Copier Interface) and Option 3A (DMA Interface): 


HC: A hard copy device 
(destination only; Option 09) 
SC: Screen contents (Source only; Option 09) 
DM: The DMA interface (Option 3A) 
SG: 
PX: Pseudo-devices (Option 3A) 
CM: 


Refer to the COPY command discussion in the 47/0 Series 
Command Reference Manual for details. 


File Names 


A file name consists of two parts: a name and an optional 
extension. If an extension is used, the name and extension 
are separated by a period. 


The name must be from one to eight characters long. Any 
printing ASCII characters (ASCII decimal equivalents 32 
through 126) can appear in a name, except the following: 


Character ADE (ASCII Decimal Equivalent) 


Space 32 
42 
44 
46 
58 
59 
60 
62 
61 
63 
91 
93 
Underscore 95 
Delete 127 


Senet ors ~~ il V | a ee e 
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An extension can be from one to three characters in length. 
If the file name includes an extension, you must specify that 
extension when you reference the file in aa command. The 
same character restrictions apply to extensions as to file 
names. 


Some examples of valid file names are: 


MACRO244 
DATA-NEW 
junk 
83status.tmp 
87-plan.dat 
new.bas 


CORRECTING ERRORS IN SETUP 
COMMANDS 


If you make an error while entering a setup command, you 
can do one of three things. 


@ |f you have not yet pressed the Rtn key, you can enter the 
linedel (line-delete) character to erase the current line. 
The factory default linedel character is °n (the ASCII 
Cancel character, ADE 24); to enter this character, enter 
Ctrl-X — that is, hold down the Ctrl key and press X. 


@ lf you have not yet pressed the Rtn key, you can use the 
chardel (character-delete) character to erase the charac- 
ters, one by one, back to the error, then finish the line 
correctly. The factory default chardel character is the 
ASCIll Delete character (ADE 127); to enter this character 
press the Rub Out key. 


@ Reenter the correct form of the command. If you have 
already pressed the Rtn key, you cannot repair the com- 
mand. The terminal will execute the command, if it can; if 
it cannot, you will see an error message on the screen. 
You can usually just reenter the correct command. 
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COMMAND SYNTAX 


Figure 6-2 shows the format used throughout the rest of this 
section to present command syntax and descriptions. 


Each command description begins at the top of a column. 
The column heading is the command name. If the command 
requires or is part of any option(s), this is shown just after 
the command name. 


Following the command name is a brief statement of the 
purpose of the command. If the parameters set by the com- 
mand are saved in setup memory (and remembered when 
the terminal is turned back on), the word Memory appears 
just after the statement of purpose. 


The next line shows the command syntax. This is the 
abstract form of the command, showing the type and order 
of parameters, and which ones are required and which are 
optional. The following conventions are used: 


@ The command word is shown first, completely spelled 
out, in all capitals and in bold. 


@® Words that must be entered exactly as shown — com- 
mand words and parameters — are shown in bold type, 
like this. However, all such entries can be abbreviated to 
their shortest unambiguous form. For example, you can 
enter the command SNO Y for SNOOPY YES. 


@® Parameters in regular type are actually parameter names 
that describe the parameter to be entered. For example, 
consider the command syntax: 


BAUDRATE trans rec 


Here the parameter names trans and rec are chosen as a 
reminder that the first parameter you enter specifies the 
transmit baud rate, while the second specifies the 
receive baud rate. 
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@ Parameters are separated from the command word and 
from each other by spaces or commas. You can use 
more than one space to separate parameters, but 
repeated commas signify omitted parameters (before the 
last). For example, consider the command: 


GRIDDING 1,,100 


This command indicates that the second parameter is 
omitted and that the default value will be assumed. 


@ Parameters in square brackets — [like this] — are 
optional. 

@ When parameters are stacked in braces — net — it 
means that you must choose one from the list. When 
parameters are stacked in square brackets in this way, 
you may choose one, but need not choose any (that is, a 
default is provided). 


@ When there are several variations of the syntax, two or 
more syntax statements are used for greater clarity. 


COMMAND NAME 


Command function... 









parameter 


COMMAND SYNTAX es parameter 
parameter 





parameter explanation... 
parameter explanation... 





Succeeding paragraphs explain the command in 
detail and provide an example of its use. 
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Figure 6-2. Command Syntax Format. 
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COMMAND DICTIONARY 


BAUDRATE 


Specifies the transmitting and receiving baud rates for 
communications between the terminal and the host 
computer. 

(Memory) 


BAUDRATE trans, rec 


trans is an integer parameter specifying the baud rate 
at which the terminal transmits data. A value of 1 
indicates the use of an external device to control the 
transmission rate. The factory default transmit baud 
rate is 2400. 


rec is an integer parameter specifying the baud rate 
at which the terminal expects to receive data from the 
host. A value of 1 indicates external clocking. If you 
enter no value or a0 for “rec’’, it is set to the same 
value as “trans.” The factory default for ‘rec’ is 2400. 


Valid baud rates for both “trans” and ‘rec’”’ are: 


(external clocking) 


(sets baud rate to 134.5) 
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SETUP COMMANDS 
BAUDRATE 


NOTE 


The terminal’s baud rate settings must be compati- 
ble with the transmit and receive baud rates used by 
the host computer. 


The transmit and receive rates do not have to be set to the 
same values. Also, either the transmit or receive rate can be 
specified by an external clock while the other is specified by 
the terminal firmware. 


The following command sets the transmit rate to 9600 baud 
and the receive rate to 2400 baud. 
BAUDRATE 9600, 2400 Cr 


The following command sets the transmit baud rate to 2400 
while the receive baud rate is controlled by an external 
Clock. 


BAUDRATE 2400 1 ‘°r 


The baud rate parameter may be set for you by an initializa- 
tion file on a disk. If it is not, you may need to consult with a 
system programmer for your host computer before using 
this command. 
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SETUP COMMANDS 
BCONTINUECHARS, BENDCHARS 


BCONTINUECHARS (Option 01) 
Sets the line continue characters for Block mode. 
(Memory) 


BCONTINUECHARS xmt,rec 


xmt is a single character representing the transmit 
continue character. If ‘““xmt’ is omitted, it is set to null 
(ADE 0). Any ASCII character is valid; the factory 
default is an ampersand (&). 


rcv is an single character representing the receive 
block continue character. If “rcv” is omitted, it is set to 
null (ADE 0). Any ASCII character is valid; the factory 
default is an ampersand (&). 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to the null character (ADE 0). 


The terminal sends the “xmt” character to the host to indi- 
‘cate when a block continues to the next line. When the 
terminal receives the “rcv” block continue character, the 
terminal knows that the block it is receiving continues to the 
next line. 


The following command specifies the percent (%) as the 
transmit block continue character and the asterisk (*) as the 
receive block continue character: 


BCONTINUECHARS % * ©r 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BENDCHARS (Option 01) 
Sets the block end characters for Block mode. 
(Memory) 


BENDCHARS xmt, rcv 


xmt is a single character representing the transmit 
block end character. If “xmt” is omitted, it is set to null 
(ADE 0). Any ASCII character is valid; the factory 
default is the dollar sign ($). 


rcv is a single character representing the receive 
block end character. If “rcv” is omitted, it is set to null 
(ADE 0). Any ASCII character is valid; the factory 
default is the dollar sign ($). 





If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to the null character. 


The terminal transmits the ‘“xmt” character to the host to 
indicate the last line of a transmission in Block mode. When 
the terminal receives the “rcv” character, the terminal 
knows that it is the last line of a block transmission. 


The following command sets the block end transmit charac- 
ter to the pound sign (#) and the block end receive character 
to the ampersand (&): 


BENDCHARS # & r 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BHEADERS (Option 01) 
Sets the transmit and receive header sequences for Block 
mode. 

(Memory) 


BHEADERS Yrxmt?L, Pcrev®L 


D_ is the delimiter character. The same character must 
precede and follow each parameter. The first charac- 
ter after the command word that is nota comma, a 
space, or an edit character (see EDITCHARS) is taken 
as the delimiter character for this command. 


xmt is a string of up to ten ASCII characters that spec- 
ifies the transmit block header sequence. Any charac- 
ter except those listed under Restrictions can be used 
in the string. If “xmt” is omitted, it is set to the null 
character (ADE 0). The factory default is “HEADTX”’. 


rcv is a string of up to ten ASCII characters that speci- 
fies the receive block header sequence. Any charac- 
ter except those listed under Restrictions can be used 
in the string. If “rcv” is omitted, it is set to the null 
character (ADE 0). The factory default is “HEADRX”’. 


Restrictions. The “xmt” and “rcv” strings should not con- 
tain the delimiter character or any characters that appear in 
the prompt string. In addition, the “xmt” and “rcv” strings 
should be ones that do not normally appear in text. 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both “xmt” and “rcv” are set to the null string. 


When the terminal sends the “xmt” sequence, it signals the 
host that a block of packed data follows immediately. When 
the terminal receives the “rcv” sequence, it signals the 
terminal that a block of packed data follows immediately. 


The following command sets the transmit block header to 
“+ send” and the receive block header to “ + recve’”’: 


BHEADERS /+send/ /+recve/ ©r 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a 

disk. If it is not, you may need to consult with a system 
programmer for your host computer before using this 
command. 


4115B OPERATORS 





SETUP COMMANDS 
BHEADERS, BLENGTH 


BLENGTH Option 01) 


Sets the block length for Block mode. 
(Memory) 


BLENGTH xmt, rcv 


xmt is an integer parameter representing the transmit 
block length. The valid range of values is from five to 
65535 characters. The factory default is 256. 


rcv is an integer parameter which is the receive block 
length value. The values range from five to 65535 
characters. The factory default is 256. 





If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


The following command sets the block length to 100 for both 
xmt and rev: 
BLENGTH 100,100 Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
BLINELENGTH, BLOCKMODE 


BLINELENGTH (Option 01) 


Specifies the maximum length line that the terminal will 


transmit in Block mode. 
(Memory) 


BLINELENGTH length 


length is an integer parameter specifying the maxi- 


mum number of characters the terminal can transmit 
in one line in Block mode. The valid range is from 

12 to 65535 characters. The factory default is 70 
characters. 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


The specified line length has no effect on input to the termi- 

nal for communications in non-Block mode. 

The following command sets the line length to 55: 
BLINELENGTH 55 Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BLOCKMODE (Option 01) 
Arms the terminal for Block mode; that is, it specifies that 
the terminal will go into Block mode as soon as it receives 
the block header sequence. 

(Memory) 


BLOCKMODE yes 
ad 


yes is a keyword parameter that arms the terminal for 
Block mode. This means that the terminal will enter 
Block mode when it receives the next block header 
sequence (see BHEADER). If you enter just the com- 
mand word and no parameter, the terminal assumes 
“yes” and arms itself for Block mode. 


no is a keyword parameter specifying that the termi- 
nal is not in Block mode. If the terminal is in Block 
mode when you enter this commana4, it exits from 
Block mode immediately. This is the factory default. 


Attempting to arm the terminal for Block mode 
when it is already in Block mode will cause com- 
munications difficulties with the host computer. 


The following command causes the terminal to enter Block 
mode: 


BLOCKMODE yes Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BMASTERCHARS (Option 01) 
Sets the master characters for Block mode. 
(Memory) 


BMASTERCHARS xmt, rec 


xmt is a single character that is the transmit “master 
character” for Block mode. If you do not enter a value 
for “xmt”’ it is set to null. Any ASCII character is valid; 
the factory default is the pound sign (#). 


rcv is a single character representing the receive 
“master character” for Block mode. If you do not 
enter a value for “rcv” it is set to null. Any ASCII char- 
acter is valid; the factory default is the pound sign (#). 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word and no parameters, 
both ‘“xmt” and“rcv” are set to null. 


The following command sets the transmit master character 
to an asterisk (*) and the receive master character toa 
dollar sign ($): 


BMASTERCHARS * $ Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
BMASTERCHARS, BNONXMTCHARS 


BNONXMTCHARS (Option 01) 
Sets the non-transmittable characters for Block mode. 
(Memory) 


BNONXMTCHARS 2°x:xmt®L, PrrevPL 


D. is the delimiter character. The same delimiter char- 
acter must precede and follow each parameter. The 
first character after the command word that is not a 
comma, space, or edit character (see EDITCHARS) is 
the delimiter character for this command. 


xmt is a string of up to 20 ASCII characters that speci- 
fies the non-transmittable characters for output in 
Block mode. The factory default string is the pound 
sign, dollar sign, and ampersand (#$&). 


rcv is astring of up to 20 ASCII characters that speci- 
fies the non-transmittable characters for input in 
Block mode. The factory default string is the pound 
sign, dollar sign, and ampersand (#$&). 





If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


If you enter just the command word with no string for either 
“xmt” or “rev’’, both are set to null. 


A character is to be ‘“‘non-transmittable” because it has a 
special Block mode meaning to the terminal (such as the 
block continue, block end, or block master characters) or 
host. See the discussion of Block mode in the Host Com- 
munications Overview section. 


The following command sets the plus sign (+) and percent 
sign (%) as non-transmittable characters for both transmit- 
ting and receiving: 


BNONXMTCHARS '+%’ '+%’ Cr 


These characters may be set by an applications program on 
the host computer or by an initialization file on a disk. If they 
are not, you may need to consult with a system programmer 
for your host computer before using this command. 


6-15 


SETUP COMMANDS 
BPACKING, BREAKTIME 


BPACKING (Option 01) 
Sets the transmitting and receiving packing values for Block 
mode. 

(Memory) 


BPACKING xmt, xmtpack, rcv, rcvpack 


xmt must be set to either 7 or 8 bits. It specifies the 
size of each byte that is transmitted. The factory 
default is 7 bits. 


xmtpack must be set to 6, 7, or 8. It specifies the 
number of data bits per byte that is transmitted. The 
factory default is 6. 


rcv must be set to either 7 or 8. It specifies the size of 
each byte received from the host. The factory default 
is 7. 


rcvpack must be set to 6, 7, or 8. It specifies the num- 
ber of data bits per byte that is received. The factory 
default is 6. 


If the terminal is already armed for Block mode, this com- 
mand generates an error. See the BLOCKMODE command. 


The following command sets the “xmt” value to 8, the ‘“‘xmt- 
pack” value to 7, the “rcv” value to 8, and the “rcvpack’”’ 
value to 7: 


BPACKING 8 7 8 7 S&R 


These parameters may be set by an applications program 
on the host computer or by an initialization file on a disk. If 
they are not, you may need to consult with a system pro- 
grammer for your host computer before using this 
command. 
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BREAKTIME 


Specifies the length of the break transmission. 
(Memory) 


BREAKTIME ms 


ms is an integer parameter specifying the length of 
the interrupt, in milliseconds. The valid range is from 


0 to 65535. The factory default is 200 ms. Setting 
“ms” to 0 means that no break transmission is sent. If 
you do not enter any value for the parameter, it is set 
to zero. 





When you press the Break key, an interrupt is sent by the 
terminal to the host. The purpose of the interrupt is to halt 
execution of a host resident program or transmission of data 
from the host. 


Different host computers may require different length inter- 
rupts. The length of the interrupt sent by the terminal is 
determined by the BREAKTIME command. 


The following command sets BREAKTIME to 400 ms. 
BREAKTIME 400 Cr 


Since the interrupt is handled differently by different hosts, 
you should check with a system programmer for your host 
before using the BREAKTIME command or the Break key. 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 


BYPASSCANCEL ~°r Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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BTIMEOUT (Option 01) 


Determines how long the terminal will wait for a response 


from the host before retransmitting the previous block. 
(Memory) 


BTIMEOUT seconds 


seconds is an integer parameter specifying the num- 
ber of seconds the terminal will wait before it retrans- 


mits a block of data. Valid values are from O to 65535; 
a setting of O disables the feature. If you do not enter a 
value for the parameter, it is set to zero. The factory 
default is zero. 


If the setting is too long, you would have to wait a long time 
to become aware that there was a problem such as a block 
being lost. If it is too short, the terminal might try to senda 
block again just because the host was slow to respond. 
Setting it to zero disables the timeout feature. 


The following command sets BTIMEOUT to 2 seconds: 


BTIMEOUT 2 r 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
BTIMEOUT, BYPASSCANCEL 


BYPASSCANCEL 


Specifies the bypass cancel character. 
(Memory) 


BYPASSCANCEL char 


char is an undelimited single ASCII character. This 
parameter is usually set to either ‘r (line feed) or °r 


(carriage return). The factory default is ‘r. If no charac- 
ter is specified the parameter is set to the null charac- 
ter (ADE 0), and the bypass feature is turned off. 





Remote echo computers use Bypass mode to suppress the 
echoing of unnecessary control characters. The terminal 
uses the bypass cancel character to get out of Bypass 
mode. 


The following command sets the bypass cancel character to 
carriage return. The “tilde” before the first carriage return is 
the literal character (see EDITCHARS). 


SETUP COMMANDS 
CMAP 


CMAP 


Determines the mapping from a surface’s color indices to © 


particular color mixtures. 


CMAP surface-number, quadruple 


surface-number is an integer with one of the follow- 
ing values: 


-1 A supersurface consisting of all the bit 
planes of all other surfaces. 


1—8 A valid graphics surface number. The 


surface must be defined. 


quadruple In the command syntax, “quadruple ...” 
means one or more groups of four integers. (All the 
quadruples together are considered to be one integer 
array.) Each quadruple consists of four integers, sepa- 
rated by spaces or commas, as follows: 


<color-index> <first-color-coordinate> <second- 
color-coordinate> <third-color-coordinate > 


The integers within a quadruple have the following 
meanings: 


color-index is an integer in the range from 0 to 32767. 
The actual number of color indices is determined by 
the number of bit planes installed. If there are N bit 
planes, the maximum color index is 2’—1. Any color- 
index parameter greater than this maximum Is set to 
the maximum. 


A color index of 0 specifies the background color. 


color-coordinates are three integers that specify the 
exact color mixture to which the color-index refers. 
The color coordinates are specified in the HLS,RGB, 
CMY, or Machine RGB color coordinate system, 
whichever was specified in the last CMODE com- 
mand. (The default on power-up is the HLS coordi- 
nate system.) Adding 1000 to the final coordinate of 
any index blinks that color on and off. 
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The ranges for these color coordinate systems are as 


follows: 


HLS System: 
H (Hue) 
L (Lightness) 
S (Saturation) 


RGB System: 
R (Red) 
G (Green) 
B (Blue) 


CMY System: 
C (Cyan) 
M (Magenta) 
Y (Yellow) 


Machine RGB System: 
R (Red) 
G (Green) 
B (Blue) 





-—32768 to 32767 
0 to 100 

0 to 100 

or 1000 to 1100 


Oto 100 
Oto 100 
0 to 100 
or 1000 to 1100 


0 to 100 
Oto 100 
Oto 100 
or 1000 to 1100 


0 to 255 
Oto 255 
Oto 255 
or 1000 to 1255 


The CMAP command sets the color map for a particular 
surface; that is, it determines the mapping from the color 
indices for that surface to particular color mixtures. 


This command also sets the surface gray levels correspond- 
ing to particular colors, according to the transform: 


Gray level = 


(.30)*(Red level) + (.59)*(Green level) 


+ (.11)*(Blue level) 


The resulting gray level value is rounded to the nearest 


integer. 
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On power-up some of the color indices are assigned to the 
default color mixtures shown in Table 6-2. For terminals with 
more than the minimum number of bit planes installed, 

more default colors will be defined, up to a maximum of 255. 
These are listed in an appendix to the 47/0 Series Command 
Reference Manual. 


The following command defines color index 1 for surface 2 
to be yellow (color coordinates 180, 50, 100) in the HLS 
system. 


CMAP 2 1 180 50 100 


If the surface has more than one bit plane, more quadruples 
may be added. The terminal will process everything in 
groups of four without regard to separators. For further 
information about the CMAP command, see the <set- 
surface-color-map > command in the 4/10 Series Command 
Reference Manual. 





Table 6-2 
DEFAULT COLORS 
Color Color Coordinates 
Mixture 





oO 


Transparent 
White 

Red 

Green 

Blue 

Cyan 
Magenta 
Yellow 
Red-Yellow(Orange) 
Green-Yellow 
Green-Cyan 
Blue-Cyan 
Blue-Magenta 
Red-Magenta 

Dark Gray 
Light Gray 













OOAN OAR WDND = 
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SETUP COMMANDS 
CMAP, CMODE 


CMODE 


Sets three color mode parameters for the terminal. 


CMODE color-specifying-mode, color-overlay-mode, 
gray-mode 


color-specifying-mode determines whether the RGB 
(red,green,blue), CMY (cyan, magenta, yellow), HLS 
(hue, lightness, saturation), or machine RGB system 
of color coordinates is used for specifying color mix- 
tures in subsequent CMAP <set-surface-color-map > 
and <set-background-color > commands. The 
default is HLS. 


color-overlay-mode specifies the behavior of the 
terminal’s writing surfaces. The factory default is 
OPAQUE. 


gray-mode specifies whether the terminal displays 
colors (COL) or black and white (BW). The default is 
COL. 





Color-specifying-mode. The color-specifying-mode has 
four numeric parameters that determine the system to use. 
Table 6-3 lists the parameters and their meaning. 


In the HLS system, colors are specified by hue, lightness, 
and saturation coordinates as shown on the HLS color cone 
in Appendix G. 


The RGB system determines a color mixture by adding 
together different amounts of the additive primary colors 
(much like your television set). The system derives its name 
from the first letter of the three colors: red, green, and blue. 


The CMY system also derives its name from the three colors 


it uses: cyan, magenta, and yellow. This is very close to the 
printing process. 
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SETUP COMMANDS 
CMODE 


Color-overlay-mode. The color-overlay-mode parameter 
specifies how the writing surfaces act in relation to each 
other (see Table 6-3). 


@ The Opaque mode (Mode 1) sets all writing surfaces to 
opaque. The surface in front obscures all surfaces 
behind it. This is the factory default mode. 


@ In Subtractive mode (Mode 2), the terminal behaves like 
a light table in which the successive surfaces show 
through those on top. For subtractive mode to work prop- 
erly, the background color should be white or some other 
light color. 


@ Inthe Additive mode, colors drawn on one surface com- 
bine with colors on the surface in front of it. A red object 
on one surface, for instance, and a green object on 
another surface combine to produce a yellow color 
where the two surfaces overlap. 


Gray Mode. The gray-mode parameter determines whether 
the display will be in color or in black and white. If the 
parameter is 0 or omitted, the current gray mode setting is 
left unchanged. If the parameter is 1, the terminal is set to 
display colors. If the parameter is 2, the terminal is set to 
replace colors with gray levels, according to the transform: 


(.30)*(Red level) + (.59)*(Green level) 
+ (.11)*(Blue level) 


Gray level = 


The resulting gray level value is rounded to the nearest 
integer. 


The terminal always powers up in COL (color) mode. 
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Table 6-3 summarizes the CMODE parameters and their 
meanings. 


Table 6-3 
CMODE PARAMETERS 


Parameters Keywords and Their Meaning 


Color-specifying- 0 No Change 
mode 

RGB 

CMY 

HLS 


Machine RGB 


No Change 
Opaque 
Subtractive 
Additive 


No Change 

COL (color) 

BW 

(Black and White) 


Color-overlay-mode 


Gray-mode 


Oo" O1WDNHO;RWND = 


The following command sets the color specification to HLS, 
the color overlay to opaque, and the gray mode to color. 


CMODE 3 1 1 


For further information about the CMODE command, see 
the 4110 Series Command Reference Manual. 
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SETUP COMMANDS 
CODE, COPY 


CODE COPY 


Selects which command set the terminal will recognize. Copies data from one device to another. 


CODE vee COPY source to destination 
ANSI 
source specifies the source of the copy — that is, 


what data is to be copied. Valid sources are: 
HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 


TEK sets the terminal to respond to Tektronix 4110- 


style commands. 


ANSI sets the terminal to respond to commands using 
ANSI X3.64 syntax. 





F1:filename A file on the flexible disk in drive 1. 
TEK mode allows the terminal to process Tektronix 41 10- (Option 43) 


style graphics and terminal control commands. 
msd:filename The msd: parameter is a mass-storage 


The ANSI setting is used to allow the terminal to process device address chosen from the list 
commands in the syntax described in ANSI Standard X3.64 SO — S7,T0—T7,..., 20 — Z7 (see 
(ISO Standard 6429). Some of the terminal’s commands are the Device Names discussion at the 
specified in these standards; other commands conform to beginning of this section). (Option 45) 
the syntax, but are specific to Tektronix’s implementation of Po: 
this terminal’s firmware. Pt: One of the peripheral ports. 

P2: (Option 10) 


SC: Screen contents. (Option 09) 


to is a keyword that indicates the direction of the 
COPY operation. 
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SETUP COMMANDS 
COPY 





destination specifies the destination of the copy — 
that is, where the data is to be copied. Valid destina- 
tions are: 


HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 








A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list 
SO — S7, TO —T7, ... ,Z0 — Z7 (see 
the Device Names discussion at the 
beginning of this section). (Option 45) 


F1:filename 









PO: 

P1: One of the peripheral ports. 

P2: (Option 10) 

HC: A color hard copy device. The back- 






[background] ground parameter must be either 0 or 
1: when itis O or omitted, a black 
screen background copies as white; 
when it is 1, a black screen back- 
ground copies as black. (Option 09) 







NOTE 


File access on any device is restricted to files 
marked with the current usernumber (when rele- 
vant). That is, you can only copy a file marked with 
the current user number on the source device. 

When the file is copied to the destination device, 
the file is marked with the current user number. See 
the USERNUMBER command. 


The copy operation continues until: 
@® anend-of-file string is encountered (see EOFSTRING). 
@ you press the CANCEL key. 


@ anerror is detected. 
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An error can be caused by many things. For example, if the 
destination device is a disk drive, an error will occur if: 


@ there is no disk in the drive. — 
@ thediskis write protected. _ 


@ the destination drive is trying to write onto a bad disk 
area. 


@ there isn’t enough room on the disk to hold the entire 
output file. 


lf a COPY is invoked in Setup mode and you enter anything 
from the terminal’s keyboard during the copy, the first 130 
characters are queued and executed when the COPY is 
finished. After you enter 130 characters, the bell rings each 
time you press any key (except CANCEL). 


Before you copy a file to a disk you should make sure that 
there is enough room for the file. You can determine the 
length of an individual file as well as the room available on 
the destination disk with the DIRECTORY command. 


You cannot copy to a file or disk that is write protected. A 
disk can be write protected by the WRITE PROTECT switch 
(see Section 2) or by uncovering the notch in the disk (see 
Section 3). A file can be write protected by the PROTECT 
setup command. 


If there is already a file on the destination disk with the file 
name you specify and it is not write-protected, the existing 
file will be replaced. If the existing file is write-protected, the 
copy fails and an error message is displayed. 


The following command copies data from a file called TEST- 
DATA.TMP on the flexible disk in drive 0 to a file called 
DATA23.DAT on the same disk: 


COPY TESTDATA.TMP to DATA23.DAT °r 


The next command copies a file STUFF from the flexible 
disk in drive 1 to the output device attached to peripheral 
port 2: 


COPY F1:STUFF to P2: 
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Copy Ho fo 30° 
Copying To and From the Host 


If the source device is the host (HO:), you must begin the 
data transmission before you enter the COPY command 
from Setup mode. Once you enter the command, the termi- 
nal will wait for a data stream from the host until an end-of- 
file string comes from the host or until the CANCEL key is 
pressed. 


One way to arrange the data stream is: 


@ Type the command to the host to begin the data stream 
without the end-of-command character from outside of 
Setup mode. 


@ Enter Setup mode. 


@ Type in the COPY command with the desired 
destination. 


@ Exit Setup mode (after you press the SET UP key, the 
light in the key stays on, but data is being transmitted to 
the host). 


@ Type the end-of-command character. If your host echos 
the character typed on the terminal, the above results in 
the end-of-command character being the first character 
in the data stream. 


Another way to do this is: 


@ Program the host so that there is a delay between the 
time you enter the end-of-command character for the 
host-data-send command and the time the data stream 
begins to flow. If you use this method you should give 
yourself enough delay time to enter Setup mode and 
type the COPY command with the desired destination. 
You may also want to use the QUEUESIZE command to 
create a large input queue. 


If you specify the host as destination, then be sure that the 


host is ready to accept data, or you may lose data and/or 
cause problems with the host. 
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SETUP COMMANDS 
COPY, CRLF 


CRLF 


Specifies whether a carriage return character is displayed 
as a Carriage return or a carriage return + line feed. 
(Memory) 


CRLF } 

ino 
yes is a keyword indicating that the terminal should 
attach a line feed character to each carriage return 
character. 


no is a keyword indicating that the terminal should not 
attach a line feed charcter to the carriage return. This 
is the factory default. 





A carriage return moves the cursor back to the left margin of 
the current line; a line feed moves the cursor down one line 
from its current position. 


The following command causes the terminal to attach the 
line feed character to the carriage return: 


CRLF YES ©r 


If you set the parameter to “yes” and the host automatically 
sends a line feed character with the carriage return, the 
terminal ‘double spaces” each time you press the Rtn key 
because it is getting a line feed from the host and from the 
terminal. 


If the terminal is in Local mode, Rtn only returns the cursor 
to the left margin of the current line unless CRLF is set to 


33 


yes”. 


66 


When the terminal is in Setup mode, pressing Rtn always 
gives the carriage return + line feed combination, regard- 
less of the CRLF setting. 
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SETUP COMMANDS 
DA2INDEX, DABUFFER 


DA2INDEX 


Sets the alternate color index for dialog text. 
(Memory) 


DA2INDEX index 


index is a valid color index. The range for index is 
from 0 through 32767; however, any value greater 


than the maximum index for the terminal is set to this 
maximum. If N is the number of bit planes installed in 
the terminal, then the maximum color index for the 
terminal is 2\—-1. 


This command selects the color index that will be used to 
display characters in the character set determined by the 
< select-graphic-rendition: 1> command. See the 4/710 
Series Command Reference Manual for details on graphic 
renditions. 


The color index is interpreted in terms of the color.map from 


the current graphics surface. See the discussion of the 
DASURFACE command. 
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DABUFFER 


Specifies the size of the dialog buffer. 
(Memory) 


DABUFFER lines 


lines is an integer parameter that specifies the num- 


ber of lines in the dialog buffer. The minimum dialog 
buffer size is two; the factory default is 34. 





A change in the dialog’s buffer size becomes effective the 
next time the dialog area becomes visible. 


The maximum dialog buffer depends on the amount of 
available memory. If you specify a dialog buffer larger than 
the available memory, it is set to the available memory. 


If the buffer is full when a line of text is received, the first line 
is deleted to make room for the new line. 


The following command sets the dialog buffer size to hold 
30 lines of data: 


DABUFFER 30 ‘Cr 


If you change the size of the dialog buffer, the information in 
the dialog area is not lost or changed unless the size is 
reduced. In that case, the most recent dialog text is 
retained. The new size takes effect the next time the dialog 
area becomes visible. 


If you try to make the dialog buffer smaller than the dialog 


area, an error is detected and the buffer is set to the number 
of visible lines in the dialog area. | 
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DACHARS 


Specifies the maximum number of characters per line in the 
dialog buffer. 
(Memory) 


DACHARS width 


width is an integer parameter indicating the maxi- 


mum number of characters per line. The factory 
default is 80. The minimum is 5; the maximum is 80. 





If you specify more than 80 characters per line, the terminal 
reports an error. If you specify more characters than fit due 
to the current dialog area position, the dialog area is moved 
to allow the specified width. The following warning is dis- 
played the next time the dialog area becomes visible (you 
will not see the warning if the terminal’s error reporting 
mechanism is set to suppress warnings): 


>> Terminal lssues Message LV03: 
>> Dialog Parameters Modified 


The terminal remembers the width you specified and if the 
dialog area position is changed, the width parameter is 
automatically changed accordingly. (See the DAPOSITION 
command description.) 


If you change the width, information in the dialog area is not 
lost. The new width takes effect the next time the dialog 
area is visible, and when the next text is received in the 
dialog area. 


The following command changes the maximum width of 
each line in the dialog area to 35: 


DACHARS 35 Cr 
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SETUP COMMANDS 
DACHARS, DAENABLE 


DAENABLE 


Enables or disables the dialog area. 
(Memory) 


DAENABLE ea 
no 


yes is a keyword parameter which enables the dialog 
area. If you do not specify “yes” or “no,” the parame- 
ter is set to “yes.” 


no is a keyword parameter which disables the dialog 
area. This is the factory default. 





When the dialog area is enabled, all alpha (non-graphics) 
text is directed to it. The dialog area is made visible or invisi- 
ble by a separate command (see the DIALOG key in Section 
2 or the DAVIS command in this section). If the dialog area is 
enabled when you turn the terminal on, the dialog area will 
automatically be visible. 


When the dialog area is disabled, alpha text is directed to 
the graphics area of the screen. If the dialog area is visible 
but not enabled, you can see text written in the dialog area 
before it was disabled, but the subsequent text will not go 
into the dialog area. 


When the dialog area is enabled, pressing the Rtn key does 
not cause the terminal to exit from Vector, Marker, or 4010- 
style GIN mode. If you are in one of those modes at the end 
of a program, press the CANCEL key to return the terminal 
to Alpha mode. 


The following command enables the dialog are: 


DAENABLE Cr 
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SETUP COMMANDS 
DAINDEX, DALINES 


DAINDEX 


Specifies color indices in the dialog area. 
(Memory) 


DAINDEX character, background 


character is an integer parameter specifying the color 
index of text in the dialog area. The factory default for 
the character parameter is 1 (white). 


background is an integer parameter specifying the 
color index of the background of the character cell in 
which the character is drawn. The factory default is 0 
(transparent). 


The range for both character and background is from 
0 through 32767. The actual number of distinct color 
indices in the terminal depends on the number of bit 
planes installed. If N is the number of bit planes, the 
maximum index number is 2—1. If you specify a color 
index larger than this maximum, it is set to the 
maximum. 


With the standard four bit planes, color indices range from 0 
to 15. With six bit planes, color indices range from 0 to 63. 
With eight bit planes, color indices range from 0 to 255. 


NOTE 


Other 4110 Series terminals may process a third 
parameter (called a wipe index) in this command. 
For compatibility, this terminal accepts the third 
parameter, but ignores it. 


When you change a dialog area index, it is effective the next 
time the dialog area is made visible. Characters already in 
the dialog area are not affected. 


Note that if you set both indices to 0, the dialog area would 
be invisible because you would have transparent characters 
and transparent character cells on a transparent back- 
ground. Text in the dialog area would also be invisible if you 
set both indices the same since you would have the same 
color characters and character cells on the same color 
background. 
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DALINES 


Specifies the number of lines of the dialog buffer displayed 
on the screen. 
(Memory) 


DALINES lines 


lines is an integer parameter, specifying the number 


of lines in the dialog buffer which are to be visible. The 
factory default is five. The valid range is from 2 to 64. 





If you specify more visible lines than the current dialog area 
position allows, the terminal automatically changes the 
position to allow the specified number of lines. In that case 
the following warning is displayed the next time the dialog 
area becomes visible (you will not see the warning if the 
terminal’s error reporting mechanism is set to suppress 
warnings): 


>> Terminal Issues Message LV03: 
>> Dialog Parameters Modified 


If you change the number of visible lines, the information in 
the dialog buffer is not changed or lost. The change is effec- 
tive the next time the dialog area is made visible (see 
DAVIS). 


If you set the dialog area larger than the dialog buffer, the 
buffer size is automatically increased to match the dialog 
area size. If there is not enough terminal memory available 
to do this, both the dialog area and the dialog buffer are set 
to the maximum size allowed by the available memory. 


The following command causes 15 lines of the dialog buffer 
to be displayed at a time: 


DALINES 15 r 
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DAMODE 


Specifies the writing mode for the dialog area. 
(Memory) 


DAMODE ie sete | 
overstrike 


replace is a keyword that specifies Replace mode. In 
Replace mode, when a character is displayed it 
replaces any character previously shown there; the 
old character is erased. In addition, when you press 
the current chardel key in Setup mode, the character 
to the left of the cursor is erased when the cursor 
backs up to that character position. 


overstrike is a Keyword that specifies Overstrike 
mode. In Overstrike mode, a Space or Underscore 
character does not replace a character already dis- 
played; the old character is still displayed. The Space 
bar just moves the cursor over the character without 
erasing it; the Underscore key will underline the char- 
acter. (All other keys replace the old character, just as 
they do in Replace mode.) The current chardel key 
backspaces the cursor over the previous character, 
but does not erase it. 





NOTE 


The new DAMODE setting does not become effec- 
tive until the dialog area becomes visible. If the 


dialog area is already displayed, toggle (press twice) 


the DIALOG key to see the effects of the new 
setting. 
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SETUP COMMANDS 
DAMODE, DAPOSITION 


DAPOSITION 
Specifies the location of the lower-left corner of the dialog 


area. 
(Memory) 


DAPOSITION x, y 


x is an integer parameter specifying the X-axis coordi- 
nate of the lower-left corner of the dialog area. The 
range for this parameter is from O through 4095. 


y is an integer parameter specifying the Y-axis coordi- 
nate of the lower-left corner of the dialog area. The 
range for this parameter is from O through 4095. 





An error results if you enter “x” or “y” coordinates that are 
not within the given ranges. The position is automatically 
adjusted if the current DACHARS and DALINES settings 
would not fit in the specified position. The terminal remem- 
bers the specified location and if the line width or number of 
visible lines is changed, the location of the dialog area is 
changed appropriately. 


Note also that a y parameter greater than 3276 would place 
the dialog area above the top of the screen (Figure 6-3). 


4095,3276 





Figure 6-3. Limits for DAPOSITION. 
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SETUP COMMANDS 
DAPOSITION, DASURFACE 


If the dialog area position is modified, the following warning 
is displayed the next time the dialog area becomes visible 
(you will not see the warning if the terminal’s error reporting 
mechanism is set to Suppress warnings): 


>> Terminal lssues Message LVO3: 
>> . Dialog Parameters Modified. 


If you change the position of the dialog area, information 
already in the dialog area is not lost. It appears at its new 
position the next time the dialog area is made visible 
(see DAVIS). 


The following command moves the lower-left corner of the 
dialog area near the center of the screen (if DACHARS is 
set to 40 or more or if DALINES is set to 17 or more, the 
terminal adjusts the actual position): 


DAPOSITION 2049, 1561°R 
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DASURFACE 


Specifies the surface whose current color map will be used 


for displaying dialog text. 
(Memory) 


DASURFACE § surface-number 


surface-number is an integer that specifies a graphic 
surface in the terminal. Valid values of surface-num- 
ber are -1 and from 1 through 8, inclusive. The effec- 


tive maximum value, however, depends on the 
number of bit planes installed in the terminal. The 
factory default for DASURFACE is 1 (the front-most 
surface). 





This command selects the graphic surface whose color 
map will be used when the dialog colors are set with the 
DAINDEX or DA2INDEX commands. Since the dialog area 
is a separate surface from the graphic surfaces, this com- 
mand in effect sets the color map for the dialog “surface”’ to 
the color map of one of the graphic surfaces. This command 
will be used in conjunction with the DAINDEX and DA2IN- 
DEX commands, which set the actual color indices 
assigned to text and character background. 


For example, consider the following two commands: 


DASURFACE 2 
DAINDEX 3 6 
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The DASURFACE 2 command instructs the terminal to use 
the color map defined for graphic surface 2 when displaying 
dialog colors. The DAINDEX 3 6 command sets the dialog 
text color to color 3 and the character background color to 
color 6, as these color indices are defined for graphic 

surface 2. 


The effective maximum surface-number is determined by 
the number of bit planes installed in the terminal. If a sur- 
face-number greater than the maximum is specified, the 
surface-number is set to the maximum for the terminal. 


Before DASURFACE is effective, surfaces must be defined 
for the terminal by the < set-surface-definition > command 
(see the 4/10 Series Command Reference Manual). \f 
surfaces are not defined, DASURFACE causes an error 
message. 


NOTE 


The action of this command in some other 4110 
Series terminals is slightly different. In those termi- 
nals, DASURFACE actually instructs the terminal 
to display dialog text on the specified graphic sur- 
Jace. The resulting visual effect, however, is similar. 
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SETUP COMMANDS 
DASURFACE, DAVIS 


DAVIS 


Specifies whether or not the dialog area is visible. 
(Memory) 


DAVIS {yes\ 
no 


yes is a keyword specifying that the dialog area 
should be visible. This is the power up and reset 
default if the dialog area is enabled. If you do not 


enter “yes” or “no,” the terminal defaults to “yes.” 


no is a keyword specifying that the dialog area should 
not be visible. This is the power up and reset default if 
the dialog area is not enabled. 





Entering this command has the same effect as pressing the 
DIALOG key. DAVIS yes makes the dialog area visible and 
turns the light in the DIALOG key on. DAVIS no makes the 
dialog area invisible and turns the light in the key off. This 
command takes effect immediately 


If the dialog area is enabled when the terminal is turned on, 
the dialog area is automatically visible. 


You can use the DAVIS command to update the dialog area 
if you change any of its attributes. For example, if you 
change the dialog area’s position and the number of visible 
lines, enter the following command to make the changes 
effective: 


DAVIS °r 


Even though the dialog area may already be visible, this 
command updates it as though the dialog area were turned 
off and back on again. (You can also toggle the DIALOG key 
to update the dialog area display.) 
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SETUP COMMANDS 


DEFINE 
w 
DEFINE fo Specifying a Key or Integer 
Defines a macro and associa és it with a Key or an integer. Indicate an alphanumeric key you want to associate with a 


macro by pressing the key or by entering its ADE value. 





DEFINE [macro-id For example, the following commands both assign a macro 


b to the uppercase A. After this command, whenever you 
DEFINE key, °Lmacro®L press the uppercase A, the character sequence “a macro or 


ing” would be transmitted. 
DEFINE key, "macro [Ke macro “e] ° eune womleretansiy 


DEFINE A /amacroorstring/ Cr 
macro-identifier specifies the key or integer with DEFINE 65 /amacroorstring/ ‘r 


which this macro Is to be associated. If the command Each function key can be identified by a mnemonic abbrevi- 
is terminated after this parameter, the macro associ- ation or by an integer as in Table 6-4. 


ated with the specified key or integer is deleted. 


all is a keyword indicating that all existing macros Table 6-4 


should be deleted. 
FUNCTION KEY IDENTIFIERS 


D1, is the delimiter character. You can use any ASCII 7; 
character to delimit the macro except: Mnenomic [Integer el 





FA function key 1 
pain F2 function key 2 
ers F3 function key 3 
the “character delete” character (see FA function key 4 
EDITCHARS) FS function key 5 
the “line delete” character (see EDITCHARS) F6 function key 6 
the “literal” character (see EDITCHARS) F7 function key 7 
F8 function key 8 
The first character after the ‘‘key” parameter that is S1 shifted function key 1 
not a space, comma, or edit character is taken as the S2 shifted function key 2 
delimiter for that macro. The delimiter should not S3 shifted function key 3 
occur in the macro itself, since the second use of the S4 Snilteg TAnelOn keys 
delimiter terminates the macro 2 si act alucat c e 
S6 shifted function key 6 
; S7 shifted function key 7 
macro is the character or character string generated SB shifted function key 8 


when you press the specified key or when the host 
executes the macro. The total length of the DEFINE 
command (including the command word and macro) 
can be a maximum of 130 characters. If you want to 
include a “‘carriage return” or one of the edit charac- DEFINE F1 /amacroorstring/ rR 
ters in the macro, it must be preceded by the “literal” DEFINE 128 /amacroorstring/ Cr 
character — see the EDITCHARS command. 


The following commands show the two ways to assign ‘“‘a 
macro or string” to function key 1. 


KE is the ‘key execute delimiter” character. When this 
character appears in a macro, it changes the direction 
of the macro expansion. If the macro was directed to 
the host, the key execute delimiter causes it instead 

to be directed to the terminal; if the terminal had been 
receiving the macro it is subsequently sent to the 

host. The expansion of a subsequent macro starts in 
the same direction as when the last macro ended. The 
“key execute delimiter” is defined by the KEYEXCHAR 
command. 
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Associating a Macro With an Integer 


You can assign an integer value for the ‘‘key” to cause the 
macro to be associated with the specified integer. One valid 
range of integers is 144 to 34767. A macro associated with 
an integer in this range can only be executed by acommand 
from the host (or by using a special form of commands 
called “escape sequences’). 


Another group of macros, byte macros, are identified by 
integers in these ranges: 


@ -—32768 to —32742 
@ -—32740 to —32737 
@ —32608 to —32513 


These macros are executed when the host sends a charac- 
ter that matches the identifying integer. To match a charac- 
ter to an integer, subtract 32768 from the character’s ASCII 
decimal equivalent. For example, if you define a macro 
identified by -32743, when the host sends the —m character, 
this macro is executed, since the decimal equivalent of —u is 
25 (25-32768 = -32743). Usually byte macros are defined 
by a host or local program instead of the operator. 


} 
The following command shows how to associate “a macro 
or string” with the integer 1000: 


DEFINE 1000 /amacroorstring/ Cr 


Carriage Return and Edit Characters 


Since the carriage return control character is executed in 
Setup mode when you press the Rtn key, it must be treated 
specially to be part of a macro. The same is true for the keys 
reserved as edit characters (see EDITCHARS). 


The third character defined by EDITCHARS is the “literal” 


character. To include a carriage return or edit character ina 
macro, precede it by the literal character. 
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SETUP COMMANDS 
DEFINE 


For example, the following command programs the F2 key 
to disable the dialog area: 


DEFINE F2 /DAENABLE no~‘r/ Cr 


The “~” before the first ©r is the literal character (factory 
default). It causes the first rR to be displayed and included in 
the macro definition, rather than being executed immedi- 
ately. Another example is: 


DEFINE F4 /COPYHO: TOFO0O: HOST.DATA~Cr/ Cr 


Using the Key Execute Delimiter 


When a macro is expanded by pressing a key, every time 
the terminal encounters the key execute delimiter it 
reverses the direction of the macro expansion. (Whena 
macro is expanded from the host or from the terminal in the 
escape sequence format, the key execute delimiter charac- 
ter is ignored.) 


In the following example, the macro starts by being 
expanded to the host. When it encounters the key execute 
delimiter, it changes direction and is expanded to the termi- 
nal. The second key execute delimiter directs the flow back 
to the host again. 


DEFINE 128 /FORT GRAF ~ ra Ke Fc Soi Ke EX 
GRAF ~ ©r/ Cr 


The initial direction of a macro depends on how it was set in 
the last macro that was expanded. In the previous example, 
the second key execute character returns the flow toward 
the host. If it had not been included, the next macro would 
have been expanded by the terminal until another key exe- 
cute character was entered. 


fY oe 
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SETUP COMMANDS 
DELETE, DIRECTORY 


DELETE (Option 42) 


Deletes the specified file. 


DELETE filename 


filename is an undelimited character string identifying 
the name of the file to be deleted. 





An error results if the disk is write-protected (by the WRITE 
PROTECT switch or the write-protect notch in the disk) or if 
the file you try to delete is write-protected by the PROTECT 
setup command. 


The following command would delete the file named “info” 
from the disk: 


DELETE info 
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DIRECTORY (Option 42) 


Displays or copies directory information for a disk or file. 


DIRECTORY [source] [to destination] 


source specifies the device or file for which a direc- 
tory listing is to be generated. Valid sources are: 


FO: The flexible disk in drive 0. If no source 
parameter is specified, FO: is 
assumed. 

F1: The flexible disk in drive 1. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, disk drive 
FO: is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


F1:filename 


msd:[filename] The msd: parameter is a mass- 
storage device address chosen from 
the list SO — S7, TO—T7,..., 
Z0 — Z7 (see the Device Names dis- 
cussion at the beginning of this sec- 
tion). If only the msd: parameter is 
specified, a directory for the entire 
storage device is generated. (Option 
45) 


to is a keyword that indicates the direction in which 
information is to be copied. 


destination specifies where the directory is to be 
written. Valid destinations are: 

none specified The terminal screen. 

HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


F1:filename 


4115B OPERATORS 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list 
SO — S7, TO—T7,... ,Z0 — Z7 (see 
the Device Names discussion at the 
beginning of this section). (Option 45) 


P2: 


if no parameters are specified, the directory of the 
flexible disk in drive 0 is written to the terminal screen. 


NOTE 


Directory access on any device is restricted to files 
marked with the current user number. Therefore, 
the DIRECTORY command only displays those 
Siles marked with the current user number on the 
given source device. (However, free space informa- 
tion refers to the entire disk; see Figure 6-4). Also, 
if the destination device accepts user numbers, the 
file that the directory is written into is marked with 


the current user number. 


The following command causes the directory of a file named 
“stuff” on the disk in drive 0 to be displayed on the screen 


(Figure 6-4A). 
DIRECTORY stuff Cr 


The directory entry for each file includes the file’s name, 
size in blocks, the number of bytes in its last block, and 
whether or not it is write-protectd. 


The following command displays the directory forthe entire 


disk in drive O (Figure 6-4B): 
DIRECTORY Cr 


If you specify the host as destination for the directory, then 
be sure that the host is ready to accept data. If you do not, 
you may lose data and cause communications problems 


with the host. 
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PO 
rT: One of the peripheral ports. 


(Option 10) 





DRIVE F&O; USER NUMBER 
-NAME 

PRACTICE EXE 

HAVE A 

GOOD DAY 


NEWDATA DAT 
INITIAL CMD 


“ENTRIES USED: 36 
~ENIRLES FREE: 284 
-BLOCKS USED: 90 
-BLOCKS FREE: 218 
=~BLOCK SiZE: 2048 
A 
DRIVE FO; USER NUMBER 
-~NAME BLOCKS 
PRACTICE EXE 32 
“ENTRIES USED: 6 
“ENTRIES FREE; 314 
-BLOCKS USED: 3c 
-~BLOCKS FREE: 276 
~BLOCK SIZE: 2048 
B 


Figure 6-4. Sample Directories. 
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SETUP COMMANDS 
DISMOUNT, DUPLEX 


DISMOUNT 


Tells the terminal that a disk has been replaced. 


DISMOUNT device 


device is a device name, as specified in the Device 
Names discussion at the beginning of this section. 





This command tells the terminal that a disk has been 
replaced in the specified device. The terminal then scans 
the new disk to determine data allocation and block informa- 
tion. DISMOUNT should always be used before accessing a 
replaced storage medium. 


NOTE 


Some devices (the Option 42 and 43 flexible disk 
drives, in particular) perform the equivalent of 
DISMOUNT automatically. 





DUPLEX (Option 01) 
Specifies what kind of Duplex mode the terminal is in. 
(Memory) 


full 
normal 
auto 
super 


DUPLEX 


full specifies that the terminal is in Full Duplex. This is 
the factory default communications mode for a termi- 
nal with Option 01 installed. If you enter the command 
word and no parameters, the terminal defaults to 
“full.” 


normal specifies that the terminal is to be in Half 
Duplex Normal mode. 


auto puts the terminal into Half Duplex with Automatic 
Request to Send mode. 


super puts the terminal into Half Duplex with Supervi- 
sor mode. 


Section 5 of this manual provides a brief overview of the 


terminal’s communications modes. See the 47/0 Series 
Host Programmers Manual for further information. 
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ECHO 


Specifies whether or not the terminal provides an “echo” of 
characters typed on the keyboard and sent to the host 
computer. 

(Memory) 


ECHO eae 
no 


yes is a keyword meaning that the terminal will pro- 
vide the echo. If you enter the command word but do 


not specify ‘“‘yes” or ‘“‘no,” the terminal defaults to 


66 ” 


yes 


no is a keyword meaning that the terminal will not 
provide the echo. This is the factory default. 


The term “echo” refers to how characters are displayed on 
the terminal screen as they are typed at the keyboard. 


If the computer you log onto is a remote-echo host, it pro- 
vides the echo for you automatically. If you set the terminal 
to provide the echo too, each character is echoed twice 
when you are in communications with the host — once by 
the terminal and once by the host. 


If the computer you log onto is not a remote-echo host, enter 
the following command so the terminal will provide the echo 
when you are communicating with the host: 


ECHO yes Cr 


When the terminal is in Setup or Local modes, the echo is 
provided by the terminal regardless of the status of ECHO. 
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SETUP COMMANDS 
ECHO, EDITCHARS 


EDITCHARS 


Specifies “delete” characters for Setup mode and a “it- 
eral” character to precede control characters in macros. 
(Memory) 


EDITCHARS chardel, linedel, literal 


chardel can be any ASCII character except the “‘line- 
del” or “literal” characters. Specify a character by 
pressing the appropriate key or entering its ADE 
(ASCII Decimal Equivalent) value. The ‘‘chardel” 
character is used in Setup mode to backspace along 
a line to correct a typing error. The factory default is 
Delete (ADE 127) — the Rub Out key. 


linedel can be any ASCII except the ‘“‘chardel” or 
“literal” characters. Specify a character by pressing 
the appropriate key or entering its ADE value. The 
“linedel” character is used in Setup mode to cancel a 
line without executing it, and start a new line. The 


factory default is Cancel (ADE 24). Type the Cancel 
character from the keyboard by pressing the Ctrl and 
X keys at the same time. 


literal can be any ASCII character except the “char- 
del” or “‘linedel” characters. Specify a character by 
pressing the appropriate key or entering its ADE 
value. The factory default literal character is the 
“tilde” (~) (ADE 126). The “literal” character must 
precede the following characters if they are include 
in a macro: | 


a carriage return 
the character delete 
the line delete 

the literal character 
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SETUP COMMANDS 
EDITCHARS, EOFSTRING 


The following command specifies the ‘“‘chardel,” ‘“‘linedel,”’ 
and “literal” characters as the percent sign (%), pee sign 
(#), and dollar sign ($), respectively. 


EDITCHARS % # $ CR 


If the dialog area is not used, the terminal will always over- 
write characters when you use the “chardel” key — it will 
not replace the characters. If the dialog area is not used, the 
“linedel” key moves down to the next line instead of to the 
beginning of the current line. 


A sample of how to use the literal character is included in 
the DEFINE command description. 


You don’t have to enter all three parameters if you only want 
to change the first or second edit characters. For example, if 
you only want to change the “character delete” character, 
you could enter the following command: 


EDITCHARS & ©r 


That command changes the character delete character to 
ampersand (&) and leaves the line delete and literal charac- 
ters unchanged. 
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EOFSTRING 


Specifies the end-of-file string during SPOOL, COPY, and 
PCOPY operations. This string is used to mark the end of.a 
file. During transmission to the host, when the terminal 
reaches the end of a file, it appends this string to the trans- 
mission. When this string is sent from the host, it signals the 
terminal that the end of the file has been reached. 

(Memory) 


EOFSTRING “:string? 


. is the delimiter character. This character must 
precede and follow the end-of-file string. The first 
character after the command word that is nota 
comma, space or edit character (see EDITCHARS) is 


the delimiter character for this command. 


string is a sequence of up to ten ASCII characters. 
The first character cannot be repeated in the string. If 
you enter just the command word and no string, the 
terminal defaults to the null string. 





When the terminal is copying a file from the host, it termi- 
nates the copy when it encounters the end-of-file string. 


The end-of-file string should be set to whatever the host 
computer actually sends at the end of a file. If it is not, you 
will have to press the CANCEL key to close disk files. 


In the following command, the slash (/) is the delimiter and 
the end-of-file string is set to an ampersand (&). 
EOFSTRING /&/ Cr 


This parameter may be set by an application program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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EOLSTRING 


Assigns the end-of-line string used by the terminal. 
(Memory) 


EOLSTRING .string°L 


D_ is the delimiter character. The same character must 
precede and follow the end-of-line string. The first 
character after the command word that is not a 
comma, space, or edit character (see EDITCHARS) is 
the delimiter character for this command. 


string is the character string the terminal uses to 
signal the end of the transmission of a line of data. 
The factory default is carriage return. 


The end-of-line string is sent by the terminal at the end of (or 
during) transmissions generated by the terminal. 


When a host requests information from the terminal, the 
terminal may send it automatically, not requiring operator 
interaction. For example, the program may request a report 
of error messages or some graphics input data. In such 
cases, the terminal sends an end-of-line character to the 
host to indicate the end of its transmission. 


The following command changes the end-of-line string to 
the ‘ (line feed): 


EOLSTRING ‘‘r’ Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
EOLSTRING, EOMCHARS 


EOMCHARS 


Specifies the end-of-message (turnaround) characters. 
(Memory) 


EOMCHARS [char1] 
[char1, char2] 


char1 and char2 are undelimited ASCII characters. If 
you specify just one character, the second character 


is set to null. If you do not specify either character, 
both are set to null and no end-of-message checking 
is done at all. The default end-of-message characters 
are ©r (carriage return) and “Lt (null). 





if the terminal is in Prompt mode, Block mode or Half 
Duplex mode, it stops transmitting when it encounters 
either end-of-message character. (See the PROMPTMODE, 
BLOCKMODE, and DUPLEX commands.) 


in Prompt mode, for example, when an end-of-message 
character is transmitted, the terminal stops transmitting 
until it receives a prompt string. 


The following command sets the end-of-message charac- 
ters to ‘F (line feed) and -c (escape). 


EOMCHARS ‘r Fc Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If itis 
not, you may need to consult with a system programmer for 
your host computer before using this command. 


6-37 


SETUP COMMANDS 
ERRORLEVEL, FIXUP 


ERRORLEVEL 


Specifies how severe an error must be before it is displayed 
by the terminal. 


ERROR LEVEL 


0 specifies that all messages, warnings, errors, and 
terminal failure messages should be displayed. If you 
enter just the command word and no parameter, the 
error level is set to 0. 


1 specifies that warnings, errors and terminal failure 
messages should be displayed. 


2 specifies that errors and terminal failure messages 
should be displayed. This is the default. 


3 specifies that only terminal failure messages should 
be displayed. 


4 suppresses all messages, warnings, errors, and 
terminal failure messages. 





The ERRORLEVEL command does not affect error mes- 
sages that are generated by host resident software pro- 
grams or the host computer. 


The terminal’s error messages are stored in an error queue 
whether or not they are displayed. The application program 
can examine that queue for an error report. 


The following command would set the terminal so that only 
terminal failure messages are displayed: 
ERRORLEVEL 3 Cr 


Appendix A lists the terminal’s warnings, error messages 
and terminal failure messages related to setup commands 
discussed in this section. 
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FIXUP 


Specifies when and how thoroughly a viewport is updated. 


FIXUP level 


level is an integer parameter with a value of 0, 2, 4 or 
6. Each value specifies when the viewport is updated. 


0 the screen is updated when you press the Page 
key or VIEW key. 


2 the actions for fixup level 0 are taken and the 
display is also updated as changes are made to 
the current view. 


4 the actions for levels 0 and 2 are taken and the 
current viewport is updated when a segment oper- 
ation in XOR mode is performed. 


6 the actions for levels 0, 2 and 4 are taken and 
segments are immediately erased from the view- 
port if they are deleted or made invisible. This is 
the factory default. 


The higher the value of the “level” parameter, the more the 
current view is updated as it is changed. 


If you enter just the command word with no parameter, the 
level is set to 0. 


Regardless of the fixup level, the current view is always 
completely updated when you press the Page key; the spec- 
ified view is updated whenever you issue the RENEW setup 
command. 


4115B OPERATORS 


FLAGGING 


Specifies whether or not the terminal is to use flagging, and 
if so, what kind of flagging. 
(Memory) 


none 
input 
output 
in/out 
DTR/CTS 


FLAGGING 


none is a keyword indicating that flagging is not to be 
done. This is the factory default. 


input is a keyword indicating that when the terminal’s 
input buffer is full, the terminal sends a DC3 character 
to stop the host; it sends a DC1 character when it is 
ready to receive data again. 


output is a keyword indicating that the DC1 and DC3 
characters are used for flagging. 


in/out is a keyword indicating that the terminal and 
host both use the DC1 and DC3 characters to flag 
each other as to when to start and halt communications. 


DTR/CTS is a keyword indicating that when the termi- 
nal’s input queue is nearly full it lowers the DTR (DATA 
TERMINAL READY) line on the RS-232 connector; 
when the terminal’s input queue is ready for more 
data, the terminal raises the line. 


For output, when the host lowers the CTS (CLEAR TO 
SEND) line, the terminal stops sending data; the 
terminal resumes transmission when CTS goes high 
again. 





Flagging allows the terminal and host computer to indicate 
to each other when they are ready to send or receive data. 
This prevents their input buffers from overflowing, which 
would cause data to be lost. 


The following command causes the terminal to use input 
flagging: 
FLAGGING input Cr 


Whether or not the terminal should use flagging, and what 
kind, depends on your host computer. 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
FLAGGING, FORMAT 


FORMAT 


Initializes a disk for use. 


FORMAT device[/C][/track]... 


device is a device name, as specified in the Device 
Names discussion at the beginning of this section. 


/C is an optional parameter that indicates the for- 
mat will be limited to 8 Megabytes of disk space, to 
be compatible with the 4170 Local Programmability 
unit. If this parameter is not present, the disk is 
formatted to the specifications later in this com- 
mand description. 


/track is an integer that specifies a known bad 
track on the disk medium. You can specify up to 
five bad tracks in this manner. 





Formatting a disk destroys all information cur- 
rently on the disk. Format only new disks or disks 
whose contents you do not want to Keep. 


Do not open the door of a flexible disk drive while 
a disk is being formatted. If you do, you must close 
the door, press MASTER RESET, and reformat the 
disk. 


A disk must be formatted before it is accessed for the first 


time. FORMAT creates a predetermined number of direc- 


tory entries on the specified disk: 


Option 42, 43 (8” flexible disks) 320 entries 
4925 Flexible Disk Drive 

(5 4%” flexible disks) 64 entries 
4926 Hard Disk Drive 

(<67 Megabytes) 4096 entries 
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GAMODE, GINAREA 


GAMODE 


Specifies background for alpha text in the graphics area. 
(Memory) 


GAMODE ie } 
overstrike 


replace specifies that only the character itself is dis- 
played; the rest of the character cell is not displayed. 


This is the factory default. 


overstrike specifies that the character cell is dis- 
played at the same gray level as the current back- 
ground gray-level (see DAINDEX). 


This command is similar to DAMODE except that it affects 
the display of alpha text in the graphics area instead of the 
dialog area. 


If you enter just the command word and no parameter, the 
parameter is set to overstrike. 
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GINAREA 


Maps a specified rectangular region on a graphics input 
(GIN) device onto a specified rectangular window in termi- 
nal coordinate space. 


GINAREA device-function, window-type, 
first-corner, second-corner 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 
tablet for pick function 
port O for locator function 
port O for pick function 
port 1 for locator function 
port 1 for pick function 
port 2 for locator function 
41 port 2 for pick function 


window-type specifies the window type: 


-1 the window set by the GINWINDOW 
command 


0 the window of the current view 


1 to 64 the window of view 1 to 64, respectively 


first-corner specifies the x and y coordinates of the 
first corner of the area that you are identifying on the 
specified GIN device. The valid range for both coordi- 
nates is 0 to 4095. 


second-corner specifies the coordinates of the sec- 
ond corner of the area that you are identifying on the 
specified GIN device. The valid range for both coordi- 
nates is 0 to 4095. 





This command assumes that the GIN device is 4096 x 
4096 units square. If the device is rectangular (not square), 
the command assigns 4096 units to the long axis of the 
device, and a proportional number of units to the short axis. 


If you specify the same value for the two x-coordinates or for 
the two y-coordinates (if the GIN area is zero in either direc- 
tion) then an error is generated, except when you specify _ 
both corners to be (0,0). In this case, the GIN area defaults 
to from (0,0) to (4095,4095). | | 
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GINCURSOR 


Specifies which segment will be used as the graphics cur- 
sor for all subsequent GIN operations. 


GINCURSOR  device-function, segment-number 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 

tablet for pick function 

port O for locator function 

port O for pick function 

port 1 for locator function 

port 1 for pick function 

port 2 for locator function 

port 2 for pick function 


segment-number is the number of the segment to be 
used as a graphic cursor. Segment 0 is the crosshair 
cursor. The valid range is 0 to 32767. 





No action is seen when this command is given; the result 
will be seen later when a GINENABLE command is issued 
for the specified device-function combination. 


When a segment is used as the GIN cursor, the segment’s 
position is the point reported when a GIN event occurs. 
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GINCURSOR, GINDISABLE 


GINDISABLE 


Disables the specified graphic input (GIN) combination. 


GINDISABLE device-function 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 

tablet for pick function 

port O for locator function 

port O for pick function 

port 1 for locator function 

port 1 for pick function 

port 2 for locator function 

port 2 for pick function 





If the specified function is already disabled, the command is 
ignored. Likewise, if the specified device is for an option 
which is not present, the command is ignored; an error is 
not generated. 


This command disables the GIN function on the named 
device. It leaves the device and its port (if any) active and 
addressable for further action. 


The following command disables GIN the graphic tablet 
locator function: 


GINDISABLE 8 
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GINENABLE, GINGRIDDING 


GINENABLE GINGRIDDING 


Enables Graphic Input (GIN) mode. Establishes a grid for use in graphics input (GIN) mode. 


GINENABLE device-function, 
number-of-GIN-events 


GINGRIDDING device-function, [xgrid, ygrid] 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 
tablet for pick function 
port O for locator function 
port O for pick function 
port 1 for locator function 
port 1 for pick function 
port 2 for locator function 
41 port 2 for pick function 


thumbwheels for locator function 
thumbwheels for pick function 
tablet for locator function 
tablet for pick function 
port O for locator function 
port O for pick function 
port 1 for locator function 
port 1 for pick function 
port 2 for locator function 
41 port 2 for pick function 


xgrid specifies the distance between the grid lines 
parallel to the x-axis. The power-up default is zero; if 
you do not enter a value for “‘xgrid” it is set to zero. 
The valid range is from 0 to 4095. 


number-of-GIN-events specifies the number of points 
whose position will be reported in a GIN-report- 
sequence before the device-function combination is 
automatically disabled. 





ygrid specifies the distance between the grid lines 
parallel to the y-axis. The power-up default is zero; if 
The following example enables the graphics tablet for five you do not enter a value for “ygrid”’ it is set to zero. 
events of the locator function: The valid range is from 0 to 4095. 


GINENABLE 8 5 Cr 





Gridding is usually set by a host program when it puts the 
terminal into GIN mode. It can help you draw lines or locate 
points more precisely. 


The following command specifies the terminal’s thumb- 
wheels for the locator function and sets up a 100 x 100 grid 
for GIN input: 


GINGRIDDING 0 100 100 Cr 
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GININKING 


This command turns inking on or off for all subsequent 
operations of the specified locator or stroke function. 


GININKING device-function, inking-mode 


device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 


O thumbwheels for locator function 
8 tablet for locator function 

24 _ port O for locator function 

32 port 1 for locator function 

40 __ port 2 for locator function 


inking-mode specifies whether Inking mode is on or 
off, and if on, when it starts inking. 


turn inking off 
turn inking on 


turn inking on (start from 
GINSTARTPOINT) 
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SETUP COMMANDS 
GININKING, GINPICKAPERAT URE 


GINPICKAPERTURE 


Specifies the “a” square within which the graphics input 
device can “pick” an object. 


GINPICKAPERATURE [size] 


size specifies the length of a side of the square within 


which the graphics input device is centered. The 
default when the terminal is turned on or reset is 8. If 
you do not specify a size, the terminal defaults to 0. 





The following command specifies a pick aperture of 4. This 
creates a 4 x 4 square with the graphics input locator cen- 
tered in the square. If you attempt to “pick” an object, it 
must have its x and y coordinates within two units (plus or 
minus) of the locator device in order to be detected. 


GINPICKAPERATURE 4°R 
See the 4110 Series Host Programmers Manual and the 


4110 Series Command Reference Manual for details on 
“picking” objects on the screen. 
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SETUP COMMANDS 
GINRUBBERBAND, GINSTARTPOINT 


GINRUBBERBAND GINSTARTPOINT 
This command turns rubberbanding on or off for all subse- Sets the start point that will be used by the GINRUBBERBAND 
quent operations of the specified locator function. Rubber- and GININKING commands. 


banding is not allowed for the pick and stroke functions. | 
GINSTARTPOINT device-function, start-point 









GINRUBBERBAND device-function, 
rubberbanding-mode 





device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 






device-function indicates the graphics input device 
used and what function is being performed by the 
input (GIN) device. Valid specifications are: 






0 thumbwheels for locator function 
8 tablet for locator function 

24 _ port 0 for locator function 

32. port 1 for locator function 

40 port 2 for locator function 






O thumbwheels for locator function 
8 tablet for locator function 

24 port 0 for locator function 

32 port 1 for locator function 

40 port 2 for locator function 








start-point is the start point at which GIN-inking and 
GIN-rubberbanding begin, in x- and y-coordinates. — 
Valid range for both coordinates is from 0 through 

4095. 






rubberbanding-mode specifies whether Rubber- 
banding mode is on or off, and if on, when it starts. 






turn rubberbanding off 
turn rubberbanding on 


turn rubberbanding on 
(start at GINSTARTPOINT) 
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GINWINDOW 


Sets a window in terminal space which can be used by the 
GINAREA command. 


GINWINDOW first-corner, second-corner 


first-corner is a corner of the window in terminal 
space into which a GIN device area is mapped. The 
range of valid values is 0 to 4095 for both x and y 
coordinates. 


second-corner is another corner of the window in 
terminal space into which a GIN device area is 
mapped. The range of valid values is 0 to 4095 for 
both x and y coordinates. 


The x- and y- coordinates you assign are sorted so that any 
two opposite corners specify the rectangle. 
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SETUP COMMANDS 
GINWINDOW, HCCOPIES 


HCCOPIES (Option 09) 


Sets the number of color hardcopies produced each time 
you press the HARD COPY key, or the terminal receives a 
< hardcopy > or <4010-hardcopy > command. 


HCCOPIES number 


number is an integer in the range 0 through 65535 


that indicates the number of hardcopies to produce 
for each request. 





This command sets the number of copies produced by each 
hardcopy request. It requires the Option 09, 4691 Color 
Graphics Copier Interface, and a color copier attached to 
the terminal. A hardcopy request occurs when: 


@ You press the HARD COPY key (either shifted or 
unshifted). 


@ The terminal receives a <hardcopy> command. 
@ The terminal receives a < 4010-hardcopy > command. 


If you specify zero for the number of copies (or omit the 
parameter), one copy is produced. 


The color hardcopier interface must be currently selected to 
produce acolor hardcopy from a regular hardcopy request. 
See the HCINTERFACE command for more information. 


When the terminal is turned on, the number of copies is 
always set to one. 
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SETUP COMMANDS 
HCDATARES, HCINTERFACE 


HCDATARES (Option 09) 


Sets the color resolution of data sent to the color hardcopier. 
(Memory) 7 


HCDATARES [resolution] 


resolution is an integer parameter that must have a 


value of 1 or 2. A value of 1 sets one-byte color resolu- 
tion. A value of 2 sets two-byte color resolution. If 
omitted, one-byte resolution is set. 





One-byte color resolution formats data sent to the color 
hardcopier with one-byte resolution (two-bit precision) for 
each of three colors: red, green, and blue. Two-byte color 
resolution formats data with two-byte resolution (four-bit 
precision) for each of these colors. 


Two-byte resolution copies terminal colors more precisely, 
but slows data transfer. In addition, if you copy data from 
SC: (the screen contents) to a disk file, more storage space 
is required. 


The setting is remembered when the terminal is turned off 
or reset. 
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HCINTERFACE (Option 09) 
Sets the hardcopy interface the terminal uses to produce a 
hardcopy. 

(Memory) 


HCINTERFACE iasied 
color 


mono is a keyword specifying that the terminal use 
the monochrome hardcopy interface. This interface 


isused with the 4612, 4632, and 4634 hardcopy units. 


color is a keyword specifying that the terminal use the 
color hardcopy interface. This interface is used with 
the 4691 Color Graphics Copier. 





Either a monochrome copier or acolor copier can produce 
hardcopies. The two types of copier use different interfaces 
to the terminal. The HCINTERFACE command lets you 
choose which of the two interfaces the terminal uses when it 
produces a hardcopy. 


Hardcopies are requested in three ways: 


@ You press the HARD COPY key (either shifted or 
unshifted). 2 


@ The terminal receives a < hardcopy > command. 


@ The terminal receives a <4010-hardcopy > command. 


The hardcopy interface can be selected by either a 

< select-hardcopy-interface > command from a program 
(see 4110 Series Command Reference) or a HCINTERFACE 
command issued by the operator. The copier connected to 
the selected interface is used for all hardcopy requests until 
a different interface is selected. 


The default interface when the terminal is turned on or reset 
is monochrome. 
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HCORIENT (Option 09) 
Sets image orientation on color hardcopies. 
(Memory) 


horizontal 
vbottom 
vcenter 
vtop 


HCORIENT 


horizontal is a keyword that matches the long axis of 
the image to the long axis of the media. 


vbottom is a keyword that matches the long axis of 
the image to the short axis of the media and positions 
the image at the bottom of the media. 


vcenter is a keyword that matches the long axis of the 
image to the short axis of the media and positions the 
image at the center of the media. 


vtop is a keyword that matches the long axis of the 
image to the short axis of the media and positions the 
image at the top of the media. 


HCORIENT is one of the commands Option 09 provides for 
using the 4691 Color Graphics Copier. This command sets 
the orientation of the hardcopy image with respect to the 
hardcopy media (the paper or transparency on the copier). 
Figure 6-5 shows the possible orientations of the image with 
respect to the media. 


The orientation applies only to the 4691 Color Graphics 


Copier. The setting is retained when the terminal is turned 
off or reset. 
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SETUP COMMANDS 
HCORIENT, IGNORDEL 


IGNOREDEL 


Specifies whether or not the terminal ignores the Delete 
(Rubout) character. 
(Memory) 


IGNOREDEL {yes 
no 


yes is a keyword indicating that the delete character 


should be ignored. 


no is a keyword indicating that the delete character 
should not be ignored. This is the factory default. 





You should only set this parameter to “yes” if your program 
uses -c? as a substitute for the °L in graphics. 


The following command changes the setting of IGNOREDEL 
to “yes”: | 


IGNOREDEL Cr 





Figure 6-5. Orientation of Copier Images to Media. 
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SETUP COMMANDS 
KEYEXCHAR, LFCR 


KEYEXCHAR 


Specifies the “key execute delimiter” character. 
(Memory) 


KEYEXCHAR char 


char specifies the “key execute delimiter.” Any ASCII 


character can be used, but it is best to choose one 
that is not used in a typical text string. The factory 
default is °. (ASCII 16, or Ctrl-P from the keyboard). 





The “key execute delimiter” determines whether a macro is 
expanded by the terminal or the host. When a macro is 
being expanded by the host and the terminal encounters 
the key execute delimiter, the direction is reversed so the 
terminal is executing the macro. When it encounters 
another key execute delimiter, it causes the host to begin to 
expand the macro again. 


If the terminal is in Local or Setup mode, all macros are 
expanded locally and the key execute delimiter is ignored. 


The following command would define °n as the key execute 
delimiter: 


KEYEXCHAR 24 Cr 


For an example of the use of the key execute delimiter, see 
the DEFINE command earlier in this section. 


6-48 


LFCR 


Specifies whether a line feed character sent to the terminal 
display is interpreted as a line feed or a line feed + carriage 
return. 

(Memory) 


LFCR {yes\ 
no 


yes is a keyword indicating that the terminal should 
display ‘F (line feed) as line feed + carriage return. 


no is a keyword indicating that the terminal should not 
attach a carriage return character to each '+ (line 
feed) sent to the display. 





A carriage return causes the cursor to move to the left mar- 
gin of the current line; a line feed moves the cursor down 
one line from its current position. A carriage return + line 
feed combination moves the cursor to the left margin of the 
next line. 


NOTE 


This command affects line feed characters to the 
terminal display only. It does not affect characters 
sent to the host or transferred during file opera- 
tions. 


The following command would cause the terminal to attach 
the carriage return character to the line feed: 


LFCR Cr 


When the terminal is in Local mode, it is necessary to 
change the parameter to “yes” if you want to get the car- 
riage return + line feed combination by pressing just the 
Line Feed key. 


4115B OPERATORS 


LOAD 


Reads a file and executes it as a command file (as if com- 
mands were being received from a host with the terminal 
not in Setup mode). 


LOAD source 


source is the source of the file to be read and exe- 
cuted. Valid sources are: 


HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-stor- 
age device address chosen from the 
list SO— S7, TO—T7,..., Z0—Z7 
(see the Device Names discussion at 
the beginning of this section). 
(Option 45) 


F1:filename 


One of the peripheral ports. 
(Option 10) 





NOTE 


File access on any device is restricted to files 
marked with the current user number. Thus the 
LOAD command will only load and execute a file 
marked with the current user number. 


Pressing the CANCEL key cancels the loading of a file. All 
other input to the terminal is queued until the file is loaded 
or the operation is canceled. 


Nesting of LOAD commands is allowed. That is, a file being 
loaded can in turn contain a LOAD command, and so on. 
The limitation of nesting varies, depending on how busy the 
terminal is with other tasks. 


This command loads the file named INITLIZE from the disk 
in drive O. 


LOAD INITILIZE °r 
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SETUP COMMANDS 
LOAD, LOCKKEYBOARD 


LOCKKEYBOARD 


Locks the terminal’s keyboard. 


LOCKKEYBOARD 


As soon as you enter the command, the keyboard is locked. 


When the keyboard is locked you can still press the keys, 
but the characters are not echoed on the screen. The termi- 
nal’s bell rings when you press any key except Break or 
CANCEL. 


The keyboard should usually be locked and unlocked by the 


application program. 


Pressing the CANCEL key or the RESET button 
may cause you to lose information on the screen or 
halt other terminal operations in process. Do not 
do so unless you are sure you will not lose impor- 
tant data. 


You can unlock the keyboard by pressing the CANCEL key, 
the Break key, or the RESET button. 
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SETUP COMMANDS 
LPOS, PAGEFULL 


LPOS (Option 42, 43) 


Activates the “local programmability” operating system. 


LPOS 


If the operating system has not been loaded (is not resident 
in terminal memory), then this command causes it to be 
loaded from a file named ‘LPS.SY9’, located on a local 
programmability disk mounted in drive 0. If this file is not 
found or does not contain a valid operating system, an error 
is detected. 


If the operating system is resident, but has been deacti- 
vated (with the SLEEP command — see the 4/10 Series 
CP/M-86 System Overview Manual), this command reacti- 
vates the operating system so that it resumes operating 
where it left off. 


When this command is issued, the operating system is 
activated but Setup is not disabled. Setup mode super- 
sedes local programmability, so that you must exit Setup 
mode before local programs can run. You can enter Setup 
mode as often as you want, but use of local programs is 
suspended until you exit Setup mode. 


When local programmability is activated, the LED in the 
LOCAL key is turned on and further communications from 
the host are placed in the input queue (as if the terminal 
were in Local mode). The operating system remains active 
until the terminal is reset or powered off, or until the local 
programmability SLEEP command is issued. 


While local programmability is active, if the LED inthe 
LOCAL key is on, an operator can interact directly with the 
operating system or a local program. When the LOCAL key 
light is off, the terminal reacts in the normal way to host 
communication. 
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PAGEFULL 


Specifies action to be taken when the “page full” condition 
occurs. 
(Memory) 


none 
PAGEFULL j stop 

autocopy 

break 


none is a keyword meaning that no action is taken; 
when the cursor reaches the last line of the display, it 
returns to the upper-left corner and continues, writing 
over any text already there. This is the factory default. 
If you enter the command word with no parameter, it is 
set to “none.” 


stop is a keyword meaning that when a page full 
condition occurs, the terminal stops displaying text. 
Incoming text is stored in the input queue and dis- 
played when the page full condition is cleared. 


autocopy is a keyword meaning that when a page full 
condition occurs, the terminal makes a hardcopy of 
the screen, then erases the screen and continues. 
While the hardcopy is being made, incoming text is 
stored in the terminal’s input queue. 


break is a keyword meaning that when a page full 
condition occurs, the terminal sends an interrupt to 
the host to discontinue the sending of information 
(equivalent to pressing the Break key). 





If flagging is not being used (see the FLAGGING command 
in this section, the communications overview in Section 5, 
and the 4/10 Series Host Programmers Manual the input 
queue may be overrun when you use “‘autocopy,” due to the 
time it takes to make hardcopy. If this happens, you may 
want to implement a flagging mechanism or use the 
QUEUESIZE command to be sure that the input queue is 
large enough so that it is not overrun. 


The following command sets the terminal so that when a 
page full condition occurs, it makes a hardcopy, erases the 
screen, and then continues. | 


PAGEFULL autocopy rR 
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PARITY 


Specifies the kind of parity used by the terminal for check- 
ing input and when transmitting to a host. 
(Memory) 


none 
high 
even 
odd 
data 


PARITY 


none means that the parity bit is set to 0 for transmis- 
sion of data. 


high means that the parity bit is set to 1 for transmis- 
sion of data. 


even means that the sum of the bits in the byte must 
be even for output. 


odd means that the sum of the bits in the byte must be 
odd for output. 


data means that all eight bits are used to send data 
for output. 


Parity is a means for verifying the accuracy of communica- 
tion between the terminal and a host computer. The terminal 
does not check parity on input, but it can be set to transmit 
data according to the host computer’s parity convention. 


The following command sets the terminal to transmit odd 
parity: 

PARITY odd Cr 
This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If itis 


not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
PARITY, PASSIGN 


PASSIGN (Option 10) 


Assigns a device driver and/or an identification code to the 
specified port. 
(Memory) 


PASSIGN port, device 


port identifies the port to which a device driver and/or 
identification code is assigned. Valid port specifica- 
tions are: 

PO: peripheral port 0 

P1: peripheral port 1 

P2: peripheral port 2 


device is an integer that identifies the device driver 
that is assigned to the specified port. Valid device 
drivers are: 


Device 
4643 
4662 


Meaning 
Tektronix 4643 line printer. 


Translates terminal commands into 
4662 commands and 4662 commands 
into terminal commands; the plotter 
must be used in Block mode. 


Does not translate commands 
between the terminal and 4662. 


4662/NT 


Same as “4662” driver, but includes a 
pen changing support added by the 
plotter’s multiple-pen option. 


4662/MP 


Translates terminal commands into 
4663 commands and 4663 commands 
into terminal commands; the plotter 
must be used in Block mode. 


Translates terminal commands into 
4663 commands and 4663 commands 
into terminal commands; the plotter 
must be used in Continuous Communi- 
cations mode (use DC1/DC3 or 
CTS/DTR flagging). 


4663/NB 


Does not translate commands 
between the terminal and 4663; plotter 
must be used in Continuous Communi- 
cations mode. 


4663/NT 


General purpose; supports any Tektronix 
device with an RS-232 connector. 
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SETUP COMMANDS 
PASSIGN, PBAUD 


If you attach a device to a port, the device must be compati- 
ble with the assigned driver. 


The following command assigns the 4663 device driver to 
peripheral port 0: 
PASSIGN PO: 4663 Cr 


The following command assigns the general purpose 
device driver to peripheral port 2: 


PASSIGN P2: PPORT r 
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PBAUD (Option 10) 
Assigns a rate for transmitting and receiving data for the 


specified port. 
(Memory) 


PBAUD port, baudrate 


port indicates which port is receiving a baud rate 
assignment; valid port assignments are: 


PO: peripheral port 0 
Pi: peripheral port 1 
P2: peripheral port 2 


baudrate is an integer which specifies the rate at 
which data will pass through the assigned port. The 
factory default is 2400. 





The baud rate that you assign to each port must be compati- 
ble with the baud rate of the device you attach to the port. If 
it is not, there will be communications problems. 


Valid baud rates are: 


50 
75 
110 
134 (sets baud rate to 134.5) 
150 
300 
600 
1200 
1800 
2000 
2400 
3600 
4800 
7200 
9600 


The following command sets the baud rate at 1200 for 
peripheral port 2: 


PBAUD P2: 1200 ©r 


4115B OPERATORS 


PBITS (Option 10) 
Specifies the stop bit and data bit conventions for the indi- 
cated peripheral port. 

(Memory) 


PBITS port, stopbits, databits 


port indicates the port for which the stop bit and data 
bit conventions are specified. Valid ports are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


stopbits is an integer specifying the minimum num- 


ber of bits following the data bytes in the communica- 
tions with the device attached to the port. The 
integers 1 and 2 are valid; the factory default is 2. 


databits indicates the length in bits of the data bytes 

used to communicate with the device attached to the 
port. The integers 5, 6, 7 and 8 (representing 5-bit, 6- 
bit, 7-bit and 8-bit bytes) are valid. The factory default 
is 8. 


Both “stopbits” and “databits” for a port must be compati- 
ble with the device that is attached to that port. If they are 
not, there will be acommunications problems. 


The following command sets the data bit size to 7 and stop 
bits to 1 for peripheral port 0: 


PBITS PO: 1 7 rR 
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SETUP COMMANDS 
PBITS, PCOPY 


PCOPY (Option 10) 


Establishes a two-way path between two devices. 


PCOPY source to destination 


source indicates the device which initiates and termi- 
nates the communication. Valid devices are: 


HO: the host port 

PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


to is a keyword that indicates the flow of the copy — 


from the source to the destination. 


destination specifies the device that is originally on 
the receiving end of the communication path. Valid 
devices are: 


HO: the host port 

PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


Since the data path is two-way, the two devices can carry on 
communication without involving the terminal. It is as if the 
terminal were not present and the two devices were con- 
nected directly to each other. 


The connection between the devices is established by the 
PCOPY command. Communications must be started by the 
“source” device. The connection is broken when the termi- 
nal detects an end-of-file string (see PEOF) from the source 
device, when you press the CANCEL key, or if there is an 
error. 
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SETUP COMMANDS 
PCOPY, PEOF 


The Setup mode prompt reappears on the screen when 
PCOPY is finished. The first 130 characters you type during 
PCOPY are stored in a queue. They are echoed and exe- 
cuted when PCOPY is finished. 


The following command allows the host and the device 
attached to peripheral port 2 to transfer data without involv- 
ing the terminal: 


PCOPY HO: to P2: °r 


If the source device is the host (HO:), then you must arrange 
to begin the data stream before you enter the command in 
Setup mode, because once the command is entered the 
terminal will wait for a data stream from the host until an 
end-of-file comes from the host or the CANCEL key is 
pressed. 


Two ways to start the data stream appropriately are: 


1. Type the command to the host to start the data stream 
without the end-of-command character outside of 
Setup mode, enter Setup mode, type in the PCOPY 
command with the desired destination, exit Setup 
mode, and type the end-of-command character. This 
should start the data stream from the host. If your host 
echos the characters typed on the terminal this method 
results in the end-of-command character being the first 
character in the data stream. 


2. Program the host so that there is a delay between the 
time you enter the end-of-command character for the 
host-data-send command and the time the data stream 
begins to flow. If you use this method you should give 
yourself enough time to enter Setup mode and type the 
PCOPY command with the desired destination. 
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PEOF (Option 10) 
Specifies the string to be sent to the peripheral; port when 
an end-of-file is detected by the terminal. 

(Memory) 


PEOF port, °:string? 


port indicates the port for which the specified string 
denotes end-of-file. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


D_ is the delimiter character, which must precede and 
follow the end-of-file string. The first character after 
the command word that is not a comma, space or edit 
character (see EDITCHARS) is the delimiter character 
for this command. 


string is a sequence of up to ten ASCII characters. 
The factory default is the null string. 





The port-EOF string that you assign to a port should be the 
same as the end-of-file string for the device attached to that 
port. 


In the following command, the slash (/) is used as the delim- 
iter and the “peripheral end-of-file”’ string is set to “????”’. 


PEOFP1: /2772/ °r 
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PEOL (Option 10) 
Assigns the end-of-line string to be used by the specified 
peripheral port. 

(Memory) 


PEOL port, cstring°L 


port indicates the port for which the specified string 
denotes end-of-line. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


D. is the delimiter character, which must precede and 
follow the end-of-line string. The first character after 
the command word that is not a comma, space or edit 
character (see EDITCHARS) is the delimiter character 
for this command. 


string consists of one or two ASCII characters. The 
factory default is carriage return. 


This string will replace carriage returns in data sent to the 
specified port when that port has been assigned a 4643 
device driver with the PASSIGN command. Refer to the 
4110 Series Command Reference Manual. 


In the following command, the end-of-line string for periph- 
eral port 0 is set to be a'r (line feed). 


PEOL Po: ‘‘rF’ ©r 
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SETUP COMMANDS 
PEOL, PFLAG 


PFLAG (Option 10) 
Sets the Flagging mode for the specified peripheral port. 
(Memory) 


PFLAG port, flag, [go], [stop] 


port indicates the port for which Flagging mode is 
being defined. Valid ports are: 


PO: peripheral port 0 
P1: peripheral port 1 
P2: peripheral port 2 


flag indicates which of the three types of flagging is to 
be assigned. 


NONE = _ no flagging 
CHAR character flagging (factory default) 
DTR = DTR/CTS (hardware) flagging 


go is a single character parameter which can be spec- 
ified when “character flagging” is used. The terminal 
uses the “go” character to indicate that data trans- 
mission can proceed. Any ASCII character is valid; 
DC1 (ADE 17) is the factory default. If no character is 
specified, “go” defaults to DC1. 


stop is a character parameter which can be specified 
when “character flagging” is used. The terminal uses 
the “stop” character to indicate that data transmis- 
sion should stop. Any ASCII character is valid; DC3 
(ADE 19) is the factory default. If no character is spec- 
ified, “stop” defaults to DCS. 





The following example specifies that flagging is not used at 
peripheral port 0: 


PFLAG PO: Cr 


This next command causes peripheral port 1 to use charac- 
ter flagging with ‘“?” as the “go” character and the default 
DC3 as the “stop” character: 


PFLAG P1: CHAR ? ©&r 
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SETUP COMMANDS 
PLOT, PMAP 


PLOT (Option 10) 


Copies all currently visible segments to the specified output 
device. 


PLOT to destination 


to is a keyword that indicates the direction of informa- 
tion flow. 


destination indicates the device to which the seg- 
ments will be copied. Valid choices are: 


HO: The host port. 


[FO:]filename A file on the flexible disk in drive 0. If 
only filename is specified, the device 
FO: is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


F1:filename 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— $7, TO — S7, ... ,Z0 — Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


One of the peripheral ports. 
(Option 10) 





NOTE 


File access on any device is restricted to files 
marked with the current user number. [f the PLOT 
command is used to create a file on the destination 
device, the new file is marked with the current user 
number. [f an existing filename is specified, only 
files marked with the current user number will be 
searched for. 


If you specify the host as destination, then be sure that the 
host is ready to accept the data. Otherwise you may lose 
your data or cause problems with the host. 


The following command copies the segments visible in the 
current view to the file named “picture1” on the disk: 


PLOT to picture1 Cr 


This command copies the segments to the device on 
peripheral port 2: 


PLOT to P2: ©r 
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PMAP (Option 10) 


Assigns one or more color indices to a plotter pen number. 


PMAP port, index, pen 


port indicates the port for which the index-to-pen 
assignment is valid. 


index specifies the color index assigned to a pen. A 
pen can have more than one index assigned to it. 
Valid index numbers are from —2 through 255. 


-—2 means to “unmap” (disassociate) all indices. 
—1 means to map all color indices to the given pen. 


0-255 means to map the given color index to the 
given pen. 


pen specifies the pen to which a specified color index 
_ is mapped. Valid pen numbers are integers from —1 to 
the number of pens on the plotter: 


—1 means that all plotter pens are to be 
“unmapped” (disassociated) from all color indices; 
this can only be used if “index” is set to —2. 


0 “unmap” the pen associated with a specific 
index. 


1-N specifies the pen number 





When data is drawn on the plotter, all lines with a mapped 
color index are drawn by the specified pen. Any index with- 
out a pen assignment is not drawn by the plotter. 


Mapping a color index to one pen automatically “unmaps” 
that index from any other pen. This means that while one 
pen can have several indices assigned to it, an index can be 
assigned to only one pen at atime. 


Each time the terminal is turned on, all gray-scale indices 
are initialized to pen 0. 


The following command maps color index 6 to plotter pen 1, 
attached at peripheral port 2: 


PMAP P2: 6 1 rR 


This command “unmaps’” all indices previously assigned to 
pen 1: 


PMAP P1: -2 1 Cr 
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PPARITY (Option 10) 
Assigns a Parity mode to the specified port. 
(Memory) 


low 
odd 
even 
high 
none 


PPARITY port 


port indicates the port for which parity is being 
assigned. Valid ports are: 


PO: peripheral port O 
P1: peripheral port 1 
P2: peripheral port 2 


low is a keyword indicating that the parity bit is given 
a value of 0. 


odd is a keyword indicating that the value of the parity 
bit is assigned such that the sum of all bits in the byte 
is even. 


even is a keyword indicating that the value of the 
parity bit is assigned such that the sum of all bits in 
the byte is even. 


high is a keyword indicating that the parity bit is given 
a value of 1. 


none is a keyword indicating that there is no parity 
check. 


A standard ASCII character with parity would have seven 
data bits (see PBITS) and one parity bit. 


The following command sets the terminal for even parity 
checking on peripheral port 2: 


PPARITY P2: even nr 
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SETUP COMMANDS 
PPARITY, PROMPTMODE 


PROMPTMODE 


Specifies whether or not the terminal is in Prompt mode. 


PROMPTMODE | yes 
no 


yes is a keyword which causes the terminal to enter 


Prompt mode. 


no is a keyword which causes the terminal to exit 
Prompt mode. This is the default. 





When the terminal is in Prompt mode, data from the termi- 
nal is stored in a queue and transmitted to the host when it 
is prompted to do so. If you press the CANCEL key, the 
terminal flushes the queue. If you turn Prompt mode off, all 
the characters in the queue are sent to the host. 


The character string that the terminal recognizes as a 
prompt is defined by the PROMPTSTRING command. After 
the terminal enters Prompt mode, the first prompt string is 
displayed. Subsequent prompt strings are executed, but not 
displayed. If you press the CANCEL key, Prompt mode 
starts over — that is, the first prompt after pressing CAN- 
CEL is displayed and subsequent prompts are executed. 


The following command would cause the terminal to enter 
Prompt mode: 


PROMPTMODE yes Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
PROMPTSTRING, PROTECT 


PROMPTSTRING 


Specifies the prompt sequence. 
(Memory) 


PROMPTSTRING .string?- 


D. is the delimiter character, which must precede and 
follow the prompt sequence. The first character after 


PROTECT 


Specifies the write-protect status for a file. 


PROTECT filename [yes] 
[no] 


filename is the name of the file to be accessed. Valid 
choices are: 


(Options 42,43,45) 


the command word that is not a comma, space, or edit 
character (see EDITCHARS) is the delimiter character 
for this command. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. (Option 42 or 43) 


F1:filename A file on the flexible disk in drive 1. 
(Option 43) 

msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— $7, TO—T/7,... ,Z0 — 27 (see the 
Device Names discussion at the begin- 


string is a sequence of up to ten ASCII characters. 
The factory default is the null string. 





The prompt string you specify must match the prompt string 
actually sent by your host computer. 


ning of this section). (Option 45) 


The following command sets the prompt string to ‘+ &%”: 
PROMPTSTRING /+&%/ CR NOTE 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 
not, you may need to consult with a system programmer for 
your host computer before using this command. 


File access on any device is restricted to files 
marked with the current user number, if 
relevant. You can only protect or unprotect 
files marked with the current user number. 


yes is a keyword meaning that the file should be write- 
protected. If you specify neither yes nor no, yes is 
assumed. 


no is a keyword meaning that the file should be unpro- 
tected. 





A protected file must be unprotected before it can be 
deleted or overwritten. If the disk drive is write-protected (as 
shown by the WRITE PROTECT light on the front of the 
drive), it must be unprotected before you can use PROTECT 
to change the protection status of any file on the disk in that 
drive. 


The following command write-protects the file named 
SAVEDATA on the disk in drive 1: 


PROTECT F1: SAVEDATA Cr 
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QUEUESIZE 


Specifies the size of the terminal’s input queue. 
(Memory) 


QUEUESIZE bytes 


bytes is an integer, specifying the number of bytes in 
the input queue. The factory default is 300. 





When the terminal receives data from the host faster than it 
can be processed, it stores the data in the input queue. 


If the input queue fills up and flagging (see FLAGGING) is 
not being used, the terminal ignores incoming data or text 
until there is more room in the queue. If flagging is used and 
the queue fills up, the terminal flags the host to stop sending 
data; then when there is room in the queue for more data, 
the terminal flags the host to resume sending data. 


The following command sets the input queue to 500 bytes: 


QUEUESIZE 500 Cr 


This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If itis 
not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
QUEUESIZE, RENAME 


RENAME (Option 42, 43, 45) 


Changes the name of a file on the specified disk. 


RENAME oldname to newname 
oldname is the current name of the file. 


to is a keyword which helps distinguish between 
current name of the file and its new name. 


newname is the new name of the file. 


See the File Names discussion earlier in this section 
for file name formats. 





This command changes the name of the file called oldname 
to newname. 


NOTE 


You cannot RENAME a file to a different disk or 
device location. RENAME changes only the name 
of the file. 


An error results if a file already exists with the newly speci- 
fied name. An error also occurs if no file with the specified 
“oldname” exists, or if the file you are attempting to rename 
or the disk it resides on is write protected (by the WRITE 
PROTECT switch, the write protect notch in the disk, or by 
the PROTECT command). 


The following command changes the file named 
“wrong.old” to “right”: 


RENAME wrong.old to right Cr 
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SETUP COMMANDS 
RENEW, REOM 


RENEW 


Erases the specified viewport and redraws all visible seg- 
ments. 


RENEW view 


view is an integer parameter in the range from —1 to 


64. A value of —1 renews all views; 1-64 renew the 
specified view. A value of zero renews the current 
view. 


When a viewport is renewed, it is completely updated to 
reflect all changes made to it since it was updated last. See 
the FIXUP command for more details. 
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REOM 


Specifies when the end-of-message indicator is sentina 
series of Graphics Input (GIN) reports. 
(Memory) 


REOM |} 1 
0 

1 specifies that the end-of-message indicator is sent 

after each report element and at the end of the report. 

This is the factory default. 


0 specifies that the end-of-message indicator is sent 
only at the end of the report. 





This command should be set by the applications program. If 
it has not been, you may need to see a system programmer 
for your host system for more information. 
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SETUP COMMANDS 
RLINELENGTH, RSIGCHARS 


RLINELENGTH RSIGCHARS 
Specifies the maximum length of a terminal report sent to Assigns the signature characters to be used within report 
the host computer. messages which the terminal sends to the host computer. 


RLINELENGTH length RSIGCHARS 1 report-type-code, sig-char, 


term-sig-char 


length is an integer in the range from 0 through 65535 
that specifies the maximum length in characters for 


report-type-code specifies the type of report for 
which these signature characters will be used. If this 
is a GIN device-function code, then the signature 
characters defined in this command will be used in 
GIN-report-sequences for that device-function code. If 
this parameter is —3, then these signature characters 
See the 4/10 Series Command Reference Manual for details. are used in non-GIN report messages. If the parame- 
ter is -2, these signature characters are used only 
when responding to REPORT-GIN-POINT: -2 com- 
mands. If the parameter is minus one, then these 
signature characters are used in all report messages 
(both GIN reports and non-GIN reports). 


reports the terminal sends to the host computer. The 
factory default is 0. A specification of 0 sets the maxi- 
mum length to infinity. 





sig-char is the numeric equivalent of the ASCII char- 
acter which is to be used as the sig-char in reports of 
the specified type. If the sig-char is set to Nu — 
numeric equivalent of zero — then that sig-char is 
omitted from reports sent to the host. 


term-sig-char specifies the character to be used as 
the term-sig-char in reports of the specified type. If the 
term-sig-char is ‘u, then it is omitted in reports sent to 
the host. 





If GIN is enabled for more than one device at a time, for best 
results set different sig-char and term-sig-char parameters 
for each enabled GIN device. This is necessary in order that 
the host computer can parse (interpret) the interleaved GIN- 
report-sequences which can be sent to the host if more than 
one GIN device is active. 


Also, if non-GIN reports are requested while GIN is enabled, 
then different sig-chars and term-sig-chars are needed to 
distinguish non-GIN reports from GIN reports. 


On power up, all signature characters are initialized to “vu. 
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SETUP COMMANDS 
SAVE 


SAVE 


to is a keyword to help you remember the flow of data. 
Saves the specified item to the specified file or device. 


mac mac-id 
seg seg-id 

ras numpix 
run numpix 


to destination 


mac is a keyword indicating to save a macro. 


mac-id is either an integer or “all”. When mac-id is 
“all”, all macros are saved. An integer identifies a 
particular macro to save. The integer must fall within 
one of the following ranges: 


—22768 through -—32742 

-32740 through -32737 

—32608 through —32513 
—1 through 32767 


The integer —1 indicates all macros. Other integers 
indicate macros as explained in the description of the 
DEFINE command in this section. 


seg is a keyword indicating to save a segment. 


seg-id is either an integer or “all”. When seg-id is 
“all”, allsegments are saved. An integer indicates a 
specific segment. Valid integers are: 


to plotter — same as the PLOT com- 
mand. 


all segments in the current matching 
class 


all existing segments 


1 to 32767 a specific segment 


See the 4/10 Series Host Programmers Reference 
Manual for details. 


ras is a keyword meaning to save pixels using “raster 
write” commands. 


run is a keyword meaning to save pixels using “run 
length write” commands. 


numpix is a parameter used with ras and run that 
specifies the number of pixels to save. It must be an 
integer in the range -1 through 32767. A -1 value 
means to save all pixels in the viewport. An integer in 
the range 1 through 32767 means to save that num- 
ber of pixels starting from the current beam position. 
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destination indicates the device to which data should 
be saved. Valid choices are: 


HO: The host port. 


[FO:]file name A file on the flexible disk in drive O. If 
only filename is specified, the device 
FO: is assumed. | 
(Option 42 or 43) 


Fi:filename A file on the flexible disk in drive 1, 
(Option 43) 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— S7, T0 —T7,... ,Z0 — Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


One of the peripheral ports. 
(Option 10) 





NOTE 


File access on any device is restricted to files 

marked with the current user number, if relevant. If 
you SAVE to an existing file, that file must be 
marked with the current user number. If you spec- 
ify a filename not marked with the current user 
number, a new file is created and marked. 


Graphics and macros that are saved can be put back into 
terminal memory with the LOAD command. 


If you specify the host as destination, then be sure that the 
host is ready to accept the data stream, or you may lose 
data or cause communications problems with the host. 


The following command will save all current segments to 
the device attached to peripheral port 2: 

SAVE seg all to P2: ©r 
This next command saves macro number 579 in the file 
named “macfile” on the disk in drive O: 

SAVE mac 579 to macfile ©r 
For more detailed information on pixel saving operations, 


see the 4110 Series Host Programmers Manual and the 4110 
Series Command Reference Manual. 
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SNOOPY 


Specifies whether the terminal should display control char- 
acters instead of executing them. 


SNOOPY yes| 
i 


yes is a keyword indicating that Snoopy mode should 
be initiated. 


no is a keyword indicating that Snoopy mode should 
be terminated. This is the default. The “no” specifica- 
tion puts the terminal in Alpha mode. 


When the terminal is in Snoopy mode (but not in Setup 
mode) it displays control characters instead of executing 
them. When the terminal is in Setup mode and Snoopy 
mode at the same time, it displays the control character 
then executes the control character. 


Since Snoopy mode displays characters which would other- 
wise be executed, it is a handy tooi for debugging code. 


In Snoopy mode, characters which are normally filtered out 
during communications to the host are not displayed. That 
means, for example, that even though the terminal is in 
Snoopy mode, the prompt string, block headers, and flag- 
ging characters are not displayed. 


The terminal displays control characters using the two- 
character abbreviation of control characters shown in the 
ASCII code chart (Appendix D). 


Snoopy mode can also be used to examine the contents of 
key macros without executing any commands in them. To 
do so, first enter Setup mode and give the following com- 
mand: 


SNOOPY YES Cr 
After entering this command, exit from Setup mode and 
enter Local mode. Now when you press a key which has a 


macro assigned to it, that macro is displayed but not 
expanded. 


To leave Snoopy mode, enter Setup mode and give the 
following command: 


SNOOPY NO Cr 
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SETUP COMMANDS 
SNOOPY, SPOOL 


SPOOL 


Copies data from one device to another, allowing the termi- 
nal to be used for other functions at the same time. 


SPOOL source to destination 

source indicates the source device. Valid 
sources are: 

HO: The host port. 


[FO:]filename A file on the flexible disk in drive O. If 
only filename is specified, device FO: is 
assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


F1:filename 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— S7,T0—T/7,...,Z0— Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


PO: 
P1: One of the peripheral ports. 
P2: (Option 10) 


to is a keyword that indicates the direction of the 
SPOOL operation. 


destination specifies the destination of the copy — 
that is, where the data is to be copied. When the desti- 
nation is a filename with no device specifier, a file with 
the given filename is created on the disk in drive 0. 
Valid destinations are: 


HO: The host port 


[FO:]filename A file on the flexible disk in drive 0. If 
only filename is specified, device FO: 
is assumed. (Option 42 or 43) 


A file on the flexible disk in drive 1. 
(Option 43) 


msd:filename The msd: parameter is a mass-storage 
device address chosen from the list SO 
— S7,T0—T7,... , ZO — Z7 (see the 
Device Names discussion at the begin- 
ning of this section). (Option 45) 


F1:filename 


PO: 
PT: One of the peripheral ports. 


P2: (Option 10) 


HC:[background] Acolor hard copy device. The 
background parameter must be either 
O or 1: when it is 0 or omitted, a black 
screen background copies as white; 
when it is 1, a black screen back- 
ground copies as black. (Option 09) 
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SETUP COMMANDS 
SPOOL, STATUS 


NOTE 


File access on any device ts restricted to files 
marked with the current user number, when rele- 
vant. You can only spool a file that is marked with 
the current user number. If the destination includes 
a filename, the resulting file is marked with the 
current user number. 


Once initiated, the SPOOL operation proceeds in the back- 
ground, allowing the terminal to be used for other opera- 
tions. Data is transferred from the source to the destination 
without destroying the source copy. 


Spooling continues until: 
@ the terminal receives the end-of-file string. 
@ the STOP command is issued. 


@ there is a source or destination error. 


If the “destination” is a disk drive, an output error can result 
because: 


@ there is no disk in the drive. 
@ the disk in the drive is write protected. 


@ the disk does not have enough room on it for the output 
file. 


If the last of these errors occurs, you should use a different 
disk. 


If the source is the host, you should either arrange for the 
data to be transmitted for the SPOOL before you enter 
Setup mode, or be aware that after you issue the command 
everything that comes from the host is considered data, 
including the remote character echo. 


All characters echoed from the host either before the data 
stream begins or while the data stream is flowing are sent to 
the destination device. 


This command copies “file 1”’ on disk drive 0 to the output 
device attached to peripheral port 2: 


SPOOL FO:file1 to P2: rR 


6-64 


STATUS 


Reports the terminal’s general status, the status of a group 
of related parameters, or the setting of an individual termi- 
nal parameter. 


STATUS _ [cluster] 


[command] 


If no parameter is entered, the terminal displays a 
general report of the terminal’s status. 


cluster is an undelimited alphabetic string specifying 
a Status report of a group of related parameters. Valid 
clusters are: 


report/input 

general 

communications 

optional (optional communications) 
dialog (dialog area) 

3PPI 


command is an undelimited alphabetic string that 
specifies a command or group of commands for which 
you want status. You can use a complete command 
name or abbreviation in either Setup or escape 
sequence format. If you enter an abbreviation, you 
receive status for all commands that begin with the 
abbreviation. This string can also use the escape 
character to give the status of parameters set with 
escape sequence commands. 





The following command generates a general report of the 
status of the terminal (Figure 6-6): 


STATUS rR 


This command reports the status of commands relating to 
the dialog area (Figure 6-7): 


STATUS DIALOG Cr 


This command reports the status of the BAUDRATE com- 
mand (Figure 6-8): 


STATUS BAUDRATE Cr 


When you abbreviate the name of a command, the terminal 
reports the status of all commands that begin with the 
abbreviation. For example, if you enter the following com- 
mand the terminal reports the status of all commands 
beginning with the character “E” (Figure 6-9): 


STATUS E Cr 
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lf you request a report for a command that is not stored in 
the terminal’s setup memory, there is no message. The 
cursor moves to the next line and displays the Setup mode 


prompt (*). 


If you give the full STATUS command, DABUFFER should 
be set large enough to hold the message, or else text at the 
top of the status message will be lost! 


*STATUS DIALOG 
DIALOG 
‘ DABUFFER.......---. 34 
DACHARS. «..0..-+25- 80 
DAINDEX. csc c0s.-- 1 0 0 
DAGINDEX. .c.cesecss [ 
DALINES. ..-2026.5-< 3 
DAMODE. «se ecceees- REPLACE 
DASURFACE.....:.:-5- | 
DAVIS. 6 ..sccce esses TES 
DAPOSITION,......<. 0,0 


4665-39 
Figure 6-7. The Dialog Area STATUS Report. 
*STATUS BAUDRATE 
BAUDRATE..... oases. 2400 2500 
% 
4665-40 
Figure 6-8. The STATUS BAUDRATE Report. 
“STATUS E 
EDL CHARS. . cee wae oe 
BUN ss cen eee ee sues BO 
PRRORLEVEL.....6... € 
EOMCHARS. ..sacvccs> ® © 
PULST RING. ..-55-es> 1G’ 
EOPSTRING. ...-eencs ‘) 
# 
4665-41 


Figure 6-9. The STATUS E Report. 
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SETUP COMMANDS 
STATUS 


*STATUS 
TERMINAL STATUS 


REPORT/INPUT 
REOM «sc cect wc te twee 
GINPICKAPERTURE..... 
GINWINDOW...... wees 
RLINELENGIN. «...0ses 


,0, 4095, 4095 


oOOoOtm— 


GENERAL 
PAGEP ULL. .....6...-.+ NONE 
BOLICOARS. cece ees § 1 
BOCHO. . 2c e eee cee s NO 
LOCKKEYGOAKD........ NO 
KEYEACHAR. ..5ssseves 
DAENABLE.....--..--. NO 
IGNOREDEL,...cseece « NO 
LE ORs oc cece ete et eee NU 
CRUE ve vests eee NU 
SNOOPY. . 60s cca cece es NY 
ERRORLEVEL... .2ccaees 2 


DIALOG 
DABUFFER. cee eeev ee 8 @ & 34 
DACHARS «cs scceecces 60 


DAINDEA. ..6. 5 eae 1 OOD 
DAZINDER, ....-csess | 
DALINES. «0. cc.205055 3 
DAMODE . 05s eeccenees REPLAGE 
DASURFACE...,....-.-. | 


DAVIS. eeeeeseseeee# # @ se eee? NO 
DAPOSITION..... weeere OC 
COMMUNICATIONS 


BAUDRATE.......see2. 24900 2800 
MMILIMI Tc. cs ewes as- (9200 
STOPBITS....c.ss0ees | 
AMIDELAY. ..iccc weve (UG 
PARIIY.....- seen ewess NONE 
PROMPISTRING........ — 
PROMPT MODE. .c..csces 8U 
QUE UBESIZE. ..ssse5. a+ 300 
FLAGGING. ....«... seus NONE 
EOMCHERS. ....-cssucs 4 ¥ 
EOLSTRING.....ccee-s 'H 
EOFSIRING. ..csccceace 
BREAKIIME......055-. 200 
BYPASSCANCEL......+. * 


OPTIONAL COMM 
DUPLER. sc nc cee cw ees e FULL 
BLOCKMODE.......-..- NO 
BHEADERS......:0.+-. "HEADIA' ‘HEADKX’ 
BLENGTH.....-.ss00-- €96 250 
BCONTINUECHARS...... & & 
BENDCHARS........-.. 8 $ 
BMASTERCHARS........ @ 
BLINELENGIH.....-2.., {0 
BPACKING.......:.... 7 6 7 6 


BIIMEOUL. ...00 cue ess UV , 
BNONXMTICHARS........ ‘#9&' ‘#36’ 
. 4665-38 


Figure 6-6. The STATUS Report. 
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SETUP COMMANDS 
STOP, STOPBITS 


STOP 


Halts the current “spooling” operations. 


STOP 


When a spool is halted, the output file is closed and all data 
that has already been transferred is saved. 


The command is ignored if no spool is in progress. 
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STOPBITS 


Specifies the number of stop bits used at the end of each 
character transmitted from the terminal. 
(Memory) 


STOPBITS { 1 


2 


1 indicates that the terminal appends one stop bit. 
This is the factory default. 


2 indicates that terminal appends two stop bits. 





The purpose of the “stop bit” is to indicate the end of a data 
byte sent to the host. 


The following command sets the terminal to transmit two 
stop bits at the end of each byte: 

STOPBITS 2 °rR 
This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If itis 


not, you may need to consult with a system programmer for 
your host computer before using this command. 
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TBFILTER (Options 13/14) 
Specifies the time and distance between points entered per 
stroke when the graphics tablet is in use. 


TBFILTER' device-function, distance, time 


device-function is an integer parameter indicating 
the tablet is in use. The device-function must be set 
to 10. 


distance is an integer parameter specifying the mini- 
mum x or y coordinate distance the graphics cursor or 
pen must travel before another point is transmitted to 


the program. The valid range is from 0 to 4095. The 
default is O (distance filtering is not used). 


time is an integer parameter specifying the minimum 
number of milliseconds that elapse between succes- 
sive points transmitted to the program. The valid 
range is from 0 to 65535. The default is 0 (time filter- 
ing is not used). 


Setting both distance and time to 0 disables all filtering activ- 
ity. See the 47/0 Series Host Programmers Manual discus- 
sion of GIN (Graphic Input). 


The following command sets the graphics tablet to locate 
every 100th point every 100 milliseconds: 
TBFILTER 10 100 100 Cr 


NOTE 


If both the distance and time filters are active, both 
conditions must be met before a point is transmit- 
ted. 
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SETUP COMMANDS 
TBFILTER, TBHEADERCHARS 


TBHEADERCHARS (Options 13/14) 


Specifies the header characters used in graphics input 
reports. 


TBHEADERCHARS | letters 
control 


letters specifies the characters M, J, and O as the 
header characters. This is the default. 


control specifies the control characters (GS), (SUB), 
and (US) to be the header characters. 





This emulates the HEADER strap on the TEKTRONIX 4953 
Graphics Tablet control board found in 4010 Series termi- 
nals. For more details see the description of the <set- 
tablet-status-strap > command in the 47/0 Series 
Command Reference Manual. 
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SETUP COMMANDS 
TBSIZE, TBSTATUS 


TBSIZE (Options 13/14) 
The graphic tablets included with Options 13 and 14 have a 
slightly larger active area than the TEKTRONIX 4953 and 
4954 tablets used with earlier 4010 series terminals. To 
emulate the earlier tablets more closely, the < set-tablet- 
size > command is included in versions 2 and above of the 
firmware for Options 13 and 14. 


large 
TBSIZE ; small 


automatic 


large has the tablet operating as an option to a 41 10- 

series terminal. The active area of the Option 13 tab- 

let is 121 square inches (11 x 11 in, or 279 x 279 mm). 
The active area of the Option 14 tablet is 1200 square 
inches (30 x 40 in, or 762 x 1016 mm). 


small is used when a smaller active area is required, 
to emulate more closely the 4953 and 4954 tablets 
used with earlier 4010 series terminals. The Option 13 
tablet emulates the 4953 tablet, with an active area of 
105 square inches (10.24 x 10.24 in, or 260 x 260 
mm). The Option 14 tablet emulates the 4954 tablet, 
with an active area of 1180 square inches (30.72 x 
38.4 in, or 780 x 975 mm). 


automatic is used when the tablet is enabled with an 
<enable-GIN > command from the host; the entire 
tablet area is used. When the tablet is enabled with 
the < enable-4953-tablet-GIN > command from the 
host, the smaller active area of the tablet is used, 
emulating the smaller active area of the 4953 and 
4954 tablets. 





The following command sets the terminal to use the smaller 
area of the 4953/4954 tablets. 


TBSIZESMALL Cr 
See the 4110 Series Host Programmers Manual and the 


4110 Series Command Reference Manual for detailed infor- 
mation concerning TBSIZE. 
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TBSTATUS (Options 13/14) 
Specifies whether or not the terminal status byte is sent 
when the graphics tablet pen is lifted away from the tablet 
surface. 


TBSTATUS at 
in 


out specifies that the status byte is not sent when the 
tablet pen is lifted away from the tablet surface. This 
is the default. 


in specifies that the status byte is sent when the tablet 
pen is lifted away from the tablet surface. 





This emulates the HEADER strap in the TEKTRONIX 4953 
Graphics Tablet board in 4010 Series terminals. For more 
information, see the description of the < set-tablet-status- 
strap > command in the 4/10 Series Command Reference 
Manual. 
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USERNUMBER 


Sets the user number that the terminal uses when access- 
ing files. 


USERNUMBER_user-number 


user-number is an integer from 0 through 15. 





User numbers serve to keep the files for different users 
separate in a friendly, low-security environment. For exam- 
ple, each user sharing a given terminal workstation or mass 
storage device might use a unique user number. In this way, 
each user can copy, print, transfer, delete, or create files 
without danger of destroying or damaging another user’s 
data. 


When you enter a command that includes a /device/ 
filename parameter, for either a source or destination 
parameter, the terminal accesses only information (on that 
device) that is marked with the current user number. For 
example, suppose your user number is 11. At the end ofa 
work session, you can give the command: 


COPY FO: WORKFILE.TMP to S1: WORKFILE.SAV 


The terminal copies your WORKFILE.TMP on the flexible 
disk in drive 0 to WORKFILE.SAV on the mass storage 


device in device S1: and marks the file with user number 11. 


This is also convenient for directory information. If you give 
the command: 


DIRECTORY F1: 
The terminal lists only files marked with user number 11. 
See also the following commands in this section: COPY, 


DELETE, DIRECTORY, DISMOUNT, FORMAT, LOAD, PRO- 
TECT, RENAME, SAVE, and SPOOL. 
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SETUP COMMANDS 
USERNUMBER, XMTDELAY 


XMTDELAY 


Specifies how long transmission of data to the host is halted 
after the terminal encounters an end-of-message character 
(see EOMCHAR). 

(Memory) 


XMTDELAY ms 


ms is an integer parameter representing the number 


of milliseconds delay in transmission. The acceptable 
range of values is from 0 to 65535; the factory default 
is 100. 





The following command sets the transmit delay to 300 milli- 
seconds: 


XMTDELAY 300 Cr 
This parameter may be set by an applications program on 
the host computer or by an initialization file on a disk. If it is 


not, you may need to consult with a system programmer for 
your host computer before using this command. 
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SETUP COMMANDS 
XMTLIMIT 


XMTLIMIT 


Specifies the upper limit for data transmission from the 
terminal to a host computer. 
(Memory) 


XMTLIMIT limit 


limit is an integer parameter indicating the fastest 


rate at which the terminal is to send data to a host. 
The range of valid values is from 110 to 65535; the 
factory default is 19200. 


If the host cmputer cannot effectively receive data ata arate 
at which the communications port is specified, you can use 
XMTLIMIT to cause the terminal to pace its transmission of 
data at the given limit. This lowers the effective baud rate 
without altering the baud rate itself. 


The following command sets the transmit limit to 1800 bits 
per second. 


XMTLIMIT 1800 °r 


This terminal operating parameter is host dependent. It 
should usually be set by an application program when it is 
executed from the host. If it is not, see a systems program- 
mer for your host computer for more information. See the 
4110 Series Command Reference Manual for additional 
details. 
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Appendix A 


ERROR CODES 


INTRODUCTION 


Each error condition which a 4110 Series terminal can 
detect has an error code and a severity level. 


When the terminal detects an error condition, it stores the 
error code and severity level in a limited-size queue for later 
retrieval by a REPORT-ERRORS commmand from the host. 


If the error’s severity level is greater than or equal to the 
current error threshold, then the terminal displays a mes- 
sage for the operator. When the terminal is powered up or 
reset, its error threshold is set to 2, so that the only errors 
displayed are those with a severity level of 2 or more. The 
error threshold can be changed with the SET-ERROR- 
THRESHOLD command from the host or the 
ERRORLEVEL setup command from the keyboard. 


Since the terminal has two command sets, TEK commands 
and ANSI commands, the error codes for the two sets are 
listed separately. TEK error codes begin with two alphanu- 
meric characters, while ANSI error codes begin with either a 
bracket ([) and a character, or a character and a space. 
Other than this difference, errors from the two command 
sets are treated the same. 
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SEVERITY LEVELS 


There are four severity levels, numbered from zero to three: 


@ Level 0. Errors of severity level zero are hardly errors at 
all. The associated message begins with the words “Ter- 
minal issues message...”. Typically, these errors occur 
for commands which are not installed. For instance, 
when 4112 commands are sent to a 4114, the terminal 
detects level zero errors. 


@ Level 1. Level one errors are “warnings.” The corres- 
ponding messages begin with the words “Terminal 
issues warning ...’’. Typically these occur when the com- 
mand is inappropriate: deleting a segment that does not 
exist, for example. 


@ Level 2. Level two errors result from invalid commands. 
For instance, a command’s parameter may be outside 
the specified range. The corresponding message begins 
with the words “Terminal detects error ...”. 


@ Level 3. Level three errors occur when the command is 
valid, but for some reason the terminal cannot execute 
the command. (For instance, there may be insufficient 
memory to hold all the information being included ina 
segment definition.) For these errors, the message starts 
with the word, “Terminal system error...’. 
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ERROR CODES 


ERROR CODES 


The error codes are each composed according to the follow- 
ing scheme: 


@ Each error code consists of four characters. 


@ in most error codes, the first two characters are the op 
code (operation code) for the command which causes the 
error. For example, error 1A11 is associated with the SET- 
PICK-APERTURE command. 


Some errors, however, are associated with no particular 
command. For these errors, the first two characters are a 
letter and a digit. For instance, error 1011 (invalid device- 
function code) can occur with many graphic input com- 
mands. Again, error J109 (disk hardware initialization 
error) can occur only when the terminal is turned on 
before any commands have been sent to it. 


@ The third character in an error code is a digit. Digits from 
1 to 9 name the parameter with which the error is associ- 
ated. Digit O indicates that the error is associated with 
the command as a whole: the op code itself is regarded 
as the “zeroeth parameter.” An error in the second 
parameter, for example, is indicated by the digit 2. Errors 
in parameters 10 and above are indicated by the digit 9. 


@ The fourth character in an error code is also a digit. The 
most frequently used digits here are 0, 1, 2, 3 and 9: 


0 Indicates an “existence problem.” The object referred 
to does not exist when it ought to exist, or does exist 
when it ought not to exist. 


1 Indicates an “invalid value.” 

2 Indicates an “out of memory problem.” 

3 A “context error.” The command is valid, but cannot 
be executed at this time. (For instance, trying toenda 
segment when no segment is currently being 
defined.) 

9 A hardware error prevents or halts execution. (For 


example, the door is open on a disk drive when you 
try to copy from it.) 
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For example, consider the “SO10” error code. Here, “SO” 
means the BEGIN-SEGMENT command, which has the 
syntax -cSO int. The “1” refers to the first (and only) param- 
eter of that command, which is the segment number. The 
“0” indicates an “existence problem;” the segment 
referred to already exists. 


Commands Not Installed in the Terminal 


Op codes beginning with letters from | to Z may occur in 
present or future 4110 Series terminals. When the terminal 
receives one of these escape-sequence commands and 
does not recognize that command, it detects an error of 
severity level zero. After detecting the error, the terminal 
then ignores all subsequent characters until it receives an 
Ec, Ss, Fs, or Ys character. (It does this so as to skip over any 
parameters for the unrecognized command.) 


For instance, suppose the terminal does not have Option 01 
installed, and the host sends it the following character 
sequence: 


EcODOFcKA1 


Since Option 01 is not installed, the terminal does not rec- 
ognize the SET-DUPLEX-MODE: 0 command, -cODO. On 
receiving the FcOD op code, it detects a type ODOO error 
(and displays the ODOO error message if the error threshold 
is set to zero). It ignores the following character, 0. On 
receiving the following ©c, it resumes processing of the 
characters received, so that it correctly interprets and exe- 
cutes the ENABLE-DIALOG-AREA: 1 command, -cKA1. 


If your host program sends commands that may not be 
installed in all 4110 Series terminals, then these commands 
should be followed by other commands which are recog- 
nized by all terminals in the series. For instance, after issu- 
ing commands to change raster terminal (4112, 4113, 4115) 
only settings, the host could send a Us character (the 
ENTER-ALPHA-MODE command) before sending any 
alphatext to the terminal. That way, if the program is also 
sent to a 4114 or 4116 terminal, the ¥s character causes the 
terminal to resume normal processing of the characters it 
receives. 


4115B OPERATORS 


DISK AND 3PP!| HARDWARE ERRORS 


For some disk system (Option 42, 43, or 45) or Three Port 

Peripheral Interface (Option 10) errors, the error message 
reports a “hardware error number.” Table A-1 lists the disk 
and 3PPI hardware errors: 


Table A-1 


DISK AND 3PP! HARDWARE ERRORS 


Error 

Number Explanation 

1 Disk: Cannot complete result phase. 
2 Disk: Cannot sense drive status. 

3 Disk: Cannot sense interrupt status. 
4 Disk: RQM wrong state. 

5 Disk: (Reserved.) 

6 Disk: (Reserved.) 

7 Disk: Invalid command. 

8 Disk: Bad track. 

9 Disk: Control mark. 

10 Disk: CRC (cyclic redundancy check) error. 
11 Disk: Missing address data. 

12 Disk: Missing address mark. 

13 Disk: No data. 

14 Disk: Wrong cylinder. 

15 Disk: Overrun. 

16 Disk: (Reserved.) 

17 Disk: Not two-sided. 

18 Disk: Failed command phase (bytes not output). 
33 3PPI: Circular buffer overrun. 

34 3PPI: 8250 data overrun. 

35 3PPI: Errors 33 and 34. 

36 3PPI: 8250 parity error. 

37 3PPI: Errors 33 and 36. 

38 3PPI: Errors 34 and 36. 

39 3PPI: Errors 33, 34, and 36. 

40 3PPI: 8250 framing error. 

41 3PPI: Errors 33 and 40. 

42 3PPI: Errors 34 and 40. 

43 3PPI: Errors 33, 34, and 40. 

44 3PPI: Errors 36 and 40. 

45 3PPI: Errors 33, 36, and 40. 

46 3PPI: Errors 34, 36, and 40. 

47 3PPI: Errors 33, 34, 36, and 40. 
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Disk System Context Errors 


- For some file system errors, a supplemental error message 


may be displayed. This supplemental message describes 
the type of error which has occurred. Table A-2 explains 
these context error messages: 


Table A-2 


DISK SYSTEM CONTEXT ERRORS 


Error 


Disk Full 

Drive Not Ready 
Write Protected 
Invalid Device Specifier 
File Not Found 
Directory Full 

File Full 

File Currently Being 
Written 

Invalid Media Format 
Device Busy 

Invalid File Specifier 


File Busy 


File Already Exists 


Explanation 
There is no more room to write data on 
the specified disk. 


There is no disk in the specified drive, or 
the door is open. 


The disk to which you are trying to write 
can only be read at this time. 


The device you specified is not valid for 
this command. 


The terminal cannot find the specified 
file on the specified device. 


The disk already contains the maximum 
number of files permitted. 


There is no more room to write data in 
the specified file. 


Trying to access a file that is currently 
being written to. 


The disk in the specified device is 
formatted with an unsupported format. 


| The specified device is currently active 


and therefore cannot be accessed. 


You specified a device and filename 
when only a filename is valid. 


Trying to protect or rename a file that is 
currently being written to or read. 


You are trying to rename a file to a name 
that already exists. 
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DMA Transfer Errors 


DM: Device Errors. When DM: is specified as a device (with 
Option 3A: DMA Interface installed), there are error mes- 
sages that may be reported if certain errors are generated 
(instead of the standard “Terminal detects...”). These error 
messages are: 


“DMA Option 3A There is not enough memory availa- 

failed to power up” ble to satisfy the requirements for 
DM: use. 

“Invalid DMA The parameter portion of the 

Parameter” DM:parameter device is invalid. 


Also, for some file system errors (“type 9” errors such as 
JCO9, JC39, JD39, etc.), a supplemental error message is 
displayed when an error is generated by a transfer involving 
the DMA. This supplemental message describes the type of 
error which has occurred. Table A-3 lists these errors: 


Table A-3 
DMA TRANSFER ERRORS 

Error Explanation 
Host not ready for DMA _ | The host computer is not ready to start a 
transfer DMA transfer (as indicated by the 

READY line of the DR11B board). 
Host aborted DMA The host computer has sent an ABORT 
transfer code to the terminal (via the FNCT 


lines). 


DMA transfer failed The host computer tried to transfer more 
data in a block than was specified in the 
last SET-DMA-BLOCK-SIZE command 
OR the host tried to initiate a block 
transfer before the end of the last 


terminal-to-host DMA block transfer. 


The signals sent by the host at the end 
of aDMA block transfer are invalid. 


Host termination signal 
invalid 
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Pseudo Devices. When the DMA pseudo devices are speci- 
fied as devices, there are error messages that may be 
reported if certain errors are generated (instead of the 
standard “Terminal detects...’’). These error messages are: 


“DMA Option 3A There is not enough memory availa- 
Pseudo Devices failed ble to satisfy the requirements for 
to power up” DMA pseudo device use. 


“Invalid Pseudo 
Device Parameter” 


The parameter portion of the 
pseudo device specifier is invalid. 


There is an error in the data 
received from the host computer by 
a DS: or SG: pseudo device. 


‘Data Format Error’”’ 
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TEK ERROR CODES 


%! 


%!00 


Y!11 


10 
1002 


1011 


1011 


IC13 


IC20 


IC21 


1011 


SELECT-CODE = *c%! int 


(Level 0): Unrecognized command; terminal firm- 
ware is Version 3. 


(Level 2): Invalid commana-set (must be 0 or 1.) 


(For several GIN commands.) 


(Level 2): Insufficient memory available for GIN 
functions. (Only detected at power-up or 
during a RESET.) 


(Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 


ENABLE-4953-TABLET-GIN 
DISABLE-4953-TABLET-GIN = ©c! char 


(Level 0): Unrecognized command (Option 13 or 14 
not installed). | 


SET-PICK-APERTURE = ‘clA int 


(Level 2): Invalid aperture-width (must range from 0 
to 4095). 


SET-GIN-CURSOR = ‘cIC int int 


(Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 


(Level 2): Graphic input has already been enabled 
for the specified device-function code. 


(Level 2): Segment does not exist, or is currently 
being defined. 


(Level 2): Invalid segment-number (must range from 
0 to 32767). 


DISABLE-GIN = ‘ciD int 


(Level 2): Invalid device-function code. 
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1011 
IE00 


IEO3 


IE10 


IE13 


IE21 


IF 
1011 


IFOO 


IF 10 


IF21 


IF31 


1011 


IG10 


IG21 


IG31 


ERROR CODES 


ENABLE-GIN = €clE int int 
(Level 2): Invalid device-function code. 


(Level 2): The cursor segment for the specified 
device-function code does not exist. (It 
has been deleted after the SET-GIN- 
CURSOR command which assigned it to 
that device-function code.) 


(Level 2): Command is invalid at this time. (The 
segment being used as the cursor for the 
specified device-function code is a seg- 
ment which is currently being defined.) 


(Level 2): The specified GIN device is not installed 
in the terminal. 


(Level 2): The specified GIN device is already 
enabled. 


(Level 2): Invalid number-of-GIN-events. (Must 
range from 0 to 65535.) 


SET-GIN-STROKE-FILTERING = ‘clF int int int 


(Level 2): Invalid device-function code. (See the 
table with the ENABLE-GIN command for 
valid device-function codes.) 


(Level 0): Unrecognized command. (The tablet 
option is not installed.) 


(Level 2): Stroke filtering is not valid for the speci- 
fied device-function code. (Only allowed 
for stroke function.) 


(Level 2): Invalid distance-filter (range is 0 to 
32767). 


(Level 2): Invalid time-filter (range is 0 to 32767). 


SET-GIN-GRIDDING = clG int int int 


(Level 2): Invalid device-function code. (See the 
table with the ENABLE-GIN command for 
valid device-function codes.) 


(Level 2): Gridding does not apply to the specified 
device-function code. (Gridding is not 
allowed for the stroke function.) 


(Level 2): Invalid x-grid-spacing (4112, 4113, 4114, 
4116: 0 to 4095; 4115: -2°' to 28'-1). 


(Level 2): Invalid y-grid-spacing (4112, 4113, 4114, 
4116: 0 to 4095; 4115: —23' to 23'—1). 


ERROR CODES 


IHOO 


IH11 


101 1 


1110 


21 


INOO 


IN11 


IP 
1011 


1E10 


IE13 


IP13 


A-6 


SET-TABLET-HEADER-CHARACTERS = ‘clH int 


(Level 0): Unrecognized command. (Tablet option is 
not installed.) 


(Level 2): Invalid character-set-selector. (Must be 0 
or 1; in Setup mode, must be CONTROL 
or LETTERS.) 


SET-GIN-INKING = cll int int 


(Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a table of device-function 
codes.) 


(Level 2): Inking does not apply to the specified 
device-function code. (Inking is not 
allowed for the pick function.) 


(Level 2): Invalid inking mode (must be 0, 1 or 2). 


SET-REPORT-MAX-LINE-LENGTH = clL int 


(Level 2): Invalid max-line-length. (Must range from 
0 to 65535.) 


SET-REPORT-EOM-FREQUENCY = ciM int 


(Level 2): Invalid EOM-frequency setting (must be 0 
or 1). 


SET-TABLET-SIZE = ‘cIN int 


(Level 2): Unrecognized command. (Requires ver- 
sion 2 or later of Option 13 or 14 firm- 
ware.) 


(Level 2): Invalid tablet-size-mode. (Must be 0, 1, 
or 2.) 


REPORT-GIN-POINT = ‘clP int 


(Level 2): Invalid device-function code. (See the 
description of the ENABLE-GIN com- 
mand for a list of valid device-function 
codes.) 


(Level 2): The specified GIN device is not installed 
in the terminal. 


(Level 2): A plotter device is not assigned to the 
specified port. 


(Level 2): The device-function code names a device 
which has already been enabled for a 
different graphic input function. 


1011 


IR10 


IR21 


1011 


IS21 


IS31 


ITOO 


IT11 


1011 


IVOO 


IVO3 


IV21 


IV31 


IV41 


REPORT-TERMINAL-SETTINGS = ciQ char char 


No errors are detected for this command. 


SET-GIN-RUBBERBANDING = €cIR int int 


(Level 2): Invalid device-function code. (See the 
ENABLE-GIN command for a table of 
device-function codes.) 


(Level 2): Rubberbanding does not apply to the 
specified device-function code. (Rubber- 
banding is only allowed for the locator 
function. It is not allowed for the pick and 
stroke functions.) 


(Level 2): Invalid rubberbanding mode (must be 0, 
1, or 2). 


SET-REPORT-SIG-CHARS = €clS int int int 


(Level 2): Invalid report-type-code. (Must be a valid 
device-function code, or from —1 to —3.) 


(Level 2): Invalid sig-char. (Must range from 0 to 
127). 


(Level 2): Invalid term-sig-char. (Must range from 0 
to 127.) 


SET-TABLET-STATUS-STRAP = clT int 


(Level 0): Unrecognized command. (The tablet 
option is not installed.) 


(Level 2): Invalid strap-setting (must be O or 1). 


SET-GIN-AREA = ‘clV int int xy xy 


(Level 2): Invalid device-function (see ENABLE- 


GIN). 


Unrecognized command; terminal firm- 
ware is Version 3 or earlier. 


(Level 0): 


(Level 3): Out of memory while processing com- 


mand. 


(Level 2): Invalid window-specifier (range is —1 to 


64). 


Invalid first-corner (X or Y out of range 0 
to 4095). 


(Level 2): 


(Level 2): Invalid second-corner (X or Y out of range 
0 to 4095, or area is of zero width or 


height). 


4115B OPERATORS 


IW 

IWO0 (Level 0): 
IWi1 (Level 2): 
IW21 (Level 2): 
IX 

1011 (Level 2): 
IXOO (Level 0): 
1X21 (Level 2): 
JO and J1: 

JOO2 (Level 3): 
J102 (Level 3): 
J109 (Level 3): 
JB 

JBOO (Level 0): 
JBO3 (Level 2): 
JB10 (Level 2): 
JB11 (Level 2): 
JBi2 (Level 3): 
JB13 (Level 2): 
JB19 (Level 2): 


SET-GIN-WINDOW = clW xy xy 


Unrecognized command; terminal firm- 
ware is Version 3 or earlier. 


Invalid first-corner (X or Y out of range 
—231 to 231-1), 


Invalid second-corner (X or Y out of range 
—23' to 23'—1). 


SET-GIN-DISPLAY-START-POINT =  clX int xy 


Invalid device-function parameter. (See 
ENABLE-GIN for a table of valid device- 
function codes.) 


Invalid command; firmware is Version 3 or 
earlier. 


Invalid start-point (4112, 4113, 4114, 
4116: X = Oto 4095, Y = Oto 4095; 
4115: X = -23' to 231-1, Y = -23' to 
231—1). 


Disk System Errors on Power-Up 


Memory error detected by standard firm- 
ware. 


Memory error detected by optional 
peripheral firmware. 


Hardware initialization error in option 
controller board. 


ACTIVATE-LPOS = -cJB 


Unrecognized command (Option 
42/43/45 or Version 6 or higher not 
installed). 


A filename was specified when LPOS was 
resident in terminal memory, or a filename 
was not specified, but LPOS was active. 


The boot-file was not found. 
Illegal filename. 


Out of memory while performing com- 
mand. 


Context error (local programmability 
already active). 


Disk hardware error (drive not ready, I/O 
error). 


4115B OPERATORS 


JC 
JCO1 
JCO02 


JCO3 
JC10 


JC11 
JC12 


JC13 
JC19 
JC20 
JC21 
JC22 
JC30 


JC31 
JC32 


JC33 


JC39 


ERROR CODES 


COPY = ‘cJC device string device 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


Data format error (Options 3A and 9 only). 


Out of memory while attempting DMA 
transfer (Option 3A only). 


Attempt to copy an entire disk volume 
onto itself (e.g., a copy from FO: to FO:). 


Specified source device is not installed, or 
file does not exist. 


Invalid source specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Parameter 1 context error (not an input 
device, or device is busy). 


Disk hardware error or drive not ready on 
the source device, or error in DMA block 
transfer. 


Separator parameter missing. 


Invalid separator (must be empty string or 
TO; in Setup mode, must be TO). 


Out of memory while parsing the 
parameter. 


Specified destination device is not 
installed. 


Invalid destination specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Parameter 3 context error. (Invalid desti- 
nation device, device is busy or full, or 
existing disk file is write protected.) 


Disk hardware error or drive not ready on 
the destination device, or error in DMA 
block transfer. 


A-7 


ERROR CODES 


JD 
JDOO 


JD10 


JD11 
JD12 


JD13 


JD19 


JD20 


JD21 


JD22 


JD30 


JD31 
JD32 


JD33 


JD39 


A-8 


DIRECTORY = cJD device string device 


(Level 2): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


Unrecognized command. (Disk drive 
option is not installed.) 


The specified source device is not 
installed or file does not exist. 


Invalid source specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Context error in parameter 1. (The speci- 
fied device is not a disk drive, or failed 
reading bit map.) 


Disk hardware error (or drive not ready) 
for the disk drive whose directory is being 
requested. 


Separator parameter missing. 


Invalid separator (must be empty string or 
TO). 

Out of memory while parsing the parame- 
ter. 


The specified destination device is not 
installed. 


Invalid destination specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Parameter 3 context error. (The device 
specified is not a valid destination device, 
the disk is full, or the file is write- 
protected.) 


Hardware error for the destination device. 


(I/O error, write-protect error, disk drive 
not ready, or DMA block transfer error.) 


JE 


JF 
JFOO 


JF10 
JF11 
JF12 


JF13 


JF19 


JH 
JHOO 


JHO3 


JH11 


JJ 
JJOO 


JJ10 
JJ11 
JJ13 


STOP-SPOOLING =  cJE 


No errors are detected for this command. 


FORMAT-VOLUME = cJF device 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


Unrecognized command. (Disk drive 
option not installed.) 


Device is not installed. 
Invalid device specifier. 


Out of memory while parsing the parame- 
ter. 


The device specified is not a disk drive, is 
write-protected, is busy, detects a verify 
error, detects a bit map error, or is not 
mounted. 


Hardware error at the specified disk drive. 
(Format error, drive not ready, or write- 
protect switch or notch error.) 


SET-DMA-BLOCK-SIZE = ®cJH int 


(Level 0): 


(Level 2): 


(Level 2): 


Unrecognized command (Option 3A is not 
installed.) 


Command received after DMA failed to 
power up. 


Invalid parameter (must be from 1 to 
65504). 


DISMOUNT = cJJ device 


(Level 0): 


(Level 2): 
(Level 2): 
(Level 2): 


Unrecognized commang; firmware is 
Version 3 or earlier, or there are no disk 
options installed. 


The device is not installed. 
Invalid device parameter. 


Parameter 1 context error (not a valid 
device, or device is busy). 


4115B OPERATORS 


JK DELETE-FILE = *cJK device 

JKOO (Level 2): Unrecognized command. (Disk drive 
option is not installed.) 

JK10 (Level 2): The specified file does not exist or device 
is not installed. 

JK11 (Level 2): Invalid file-specifier. 

JK12 (Level 3): Out of memory while parsing parameter. 

JK13 (Level 2): The specified device is not a disk drive, is 
write-protected, is busy, or detects a bit 
map error. 

JK19 (Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 

JL LOAD = ‘cJL device 

JLO2 (Level 3): Out of memory while performing LOAD 
command. 

JLO3 (Level 2): Nesting error. (LOAD commands are 
nested too deeply.) 

JL10 (Level 2): File or device does not exist. 

JL11 (Level 2): Invalid source specifier. 

JL12 (Level 3): Out of memory while parsing parameter, 
or while executing the command. 

JL13 (Level 2): Context error in parameter 1. (Not a valid 
source device, device is busy, or com- 
mand detects a disk format error.) 

JL19 (Level 2): Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 

JP PROTECT-FILE = -cJP device int 

JPOO (Level 2): Unrecognized command. (Disk drive 
option is not installed.) 

JP10 (Level 2): The specified file or disk drive does not 
exist. 

JP11 (Level 2): Invalid file specifier. 

JP12 (Level 3): Out of memory while parsing parameter. 

JP13 (Level 2): Either the specified device is not a disk 
drive, or the file (or entire diskette volume) 
has been write-protected. 

JP19 (Level 2): Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 

JP21 (Level 2): Invalid write-protect-mode (must be 
Oor 1). 

4115B OPERATORS 


JQ 

JQ10 
JQ11 
JQ12 


JR 
JROO 


JR10 
JR11 
JR12 
JR13 


JR19 


JR20 
JR21 


JR22 
JR30 


JR31 
JR32 
JR33 


JR39 


ERROR CODES 


REPORT-DEVICE-STATUS = cJQ device 
(Level 2): Device is not installed. 
(Level 2): Invalid device specifier. 


(Level 3): Out of memory while parsing parameter. 


RENAME-FILE = ‘cJR device string device 


(Level 2): Unrecognized command. (Disk drive 


option is not installed.) 
(Level 2): The specified device or file does not exist. 
(Level 2): Invalid old-filename specifier. 
(Level 3): Out of memory while parsing parameter. 


Parameter 1 context error (file is write- 
protected, device is busy, or command 
detects invalid disk format). 


(Level 2): 


Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 


(Level 2): 


(Level 2): Separator parameter is missing. 


(Level 2): Invalid separator (must be empty string or 


TO). 
(Level 3): Out of memory while parsing parameter. 


(Level 2): Either the device specified in parameter 3 
does not exist, or is different from the 
device specified in parameter 1, or new- 


filename already exists. 
(Level 2): Invalid new-filename specifier. 
(Level 3): Out of memory while parsing parameter. 


(Level 2): Parameter 3 context error (invalid device 


specifier). 


Disk hardware error. (I/O error, drive not 
ready, or hardware write-protect error.) 


(Level 2): 


A-9 


ERROR CODES 


JS 
JSO1 
JS02 


JSO3 


JS10 
JS11 
JS12 


JS13 


JS19 


JS20 


JS21 


JS22 
JS30 
JS31 
JS32 


JS33 


JS39 


SPOOL = 


(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 
(Level 2): 
(Level 1): 
(Level 3): 


(Level 2): 


(Level 2): 


Ec JS device string device 


Data format error (Options 3A and 9 only). 


Out of memory while attempting DMA 
transfer (Option 3A only). 


Command context error. (A spooling 
operation is already in progress.) 


Specified source does not exist. 
Invalid source specifier. 


Out of memory while parsing parameter, 
or while executing the command. 


Parameter 1 context error. (Not a valid 
source device, or device is busy.) 


Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 


Separator parameter is missing. 


Invalid separator (must be empty string or 
TO). 


Out of memory while parsing parameter. 
Specified destination does not exist. 
Invalid destination device specifier. 


Out of memory while parsing parameter, 
or while executing the command. 


Parameter 3 context error. (Not a valid 
destination, device is busy, or existing file 
is write protected or open.) 


Device hardware error (disk hardware 
error, drive not ready, or DMA block trans- 
fer error). 


JU 


JUOO 


JU11 


JV 
JVO02 


JVO1 


JV11 


JV12 


JV20 


JV21 
JV31 


JV32 


JV40 
JV41 
JV42 


JV43 


JV49 


SET-USER-NUMBER = ‘cJU int 


(Level 0): 


(Level 2): 


Unrecognized command (firmware is 
Version 3 or earlier or disk option is not 
installed). 


Invalid user-number (must be 0 to 15). 


SAVE = ‘cJV string int string device 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


(Level 2): 


Out of memory while attempting DMA 
transfer (Option 3A only). 


RAS and RUN are valid for raster termi- 
nals only. 


Invalid thing-to-be-saved. (Must be MAC, 
SEG, RAS, or RUN. The latter two codes 
are valid for 4112, 4113, and 4115 termi- 
nals only.) 


Out of memory while parsing parameter, 
or while executing the command. 


The specified macro or segment does not 
exist, or segment is being defined. 


Invalid item-number-or-count. 


Invalid separator (must be empty string or 
TO). 


Out of memory while parsing the 
parameter. 


The specified destination is not installed. 
Invalid destination specifier. 


Out of memory while parsing the parame- 
ter, or while executing the command. 


Not a valid destination device, device is 
busy, or existing disk file is write protected 
or open. 


Device hardware error. (I/O error, drive not 
ready, hardware write-protect error, or 
DMA block transfer error.) 


4115B OPERATORS 


KO: Keyboard System Errors 


KOO2 (Level 3): Out of memory while initializing the key- 
board system. 


KA ENABLE-DIALOG-AREA = cKA int 


KA11 (Level 2): Invalid enable-mode (must be 0 or 1). 


KC CANCEL = -cKC 


No errors are detected for this command. 


KD  DEFINE-MACRO = £cKD int int-array 


KD1i1 (Level 2): Invalid macro number (must be in range 


—32768 to -32742, —32740 to —-32737, 
-—32608 to -32513, or —1 to 32767). 


KD21 (Level 2): Invalid int-array (length must be from 0 to 


65535, int values must be from 0 to 127). 


KD22 (Level 3): Insufficient memory to define macro. 


KE SET-ECHO = ‘cKE int 


KE11 (Level 2): Invalid echo-mode (must be 0 or 1). 


KF LFCR = ‘cKF int 
KF11 (Level 2): Invalid LFCR-mode (must be 0 or 1). 


KH HARDCOPY = ‘ckH int 


KHO1 (Level 2): Copier fault condition; operator assist- 


ance required (Option 9 only). 


KH11 (Level 2): Invalid hard-copy-code (must be 0, 1, or 


2). 


KI IGNORE-DELETES = cKl int 


Kl11 (Level 2): Invalid ignore-deletes mode (must be 
Oor 1). 


KL LOCK-KEYBOARD = cKL int 


KL11 (Level 2): Invalid keyboard-lock-mode (must be 


Oor 1). 


4115B OPERATORS 


KM 
KMOO 


KM11 


KN 
KNO2 


KN10 
KN11 


KP 
KP11 


KQ 


ERROR CODES 


SET-MARGINS = cKM int 


(Level 0): Unrecognized command. (The terminal is 
not a 4114 or 4116.) 


(Level 2): Invalid number-of-margins (must be from 
1 to 8). 


RENEW-VIEW = ©cKN int 


(Level 3): Out of memory while attempting to renew 
a view. (This error can also occur as a 
result of pressing the PAGE key.)(4112, 
4113, and 4115 only.) 


(Level 2): The view specified does not exist. 


(Level 2): Parameter out of range (must range from 
-—32768 to 32767). 


SET-PAGE-FULL-ACTION = cKP int 
(Level 2): Invalid page-full-action. (Must range from 


0 to 7.) 


REPORT-ERRORS = -cKQ 


No errors are detected for this command. 


KR 
KR11 


KS 
KS11 


KT 
KT 11 


KV 


CRLF = -cKR int 
(Level 2): Invalid CRLF-mode (must be 0 or 1). 


SET-SNOOPY-MODE = cKS int 


(Level 2): Invalid stoopy-mode (must be 0 or 1) 
SET-ERROR-THRESHOLD = ‘cKT int 
(Level 2): Invalid error-threshold-level (must be from 


0 to 4). 


RESET = cKV 


No errors are detected for this command. 


ERROR CODES 


KX 
KX1 1 


KY 
KY11 


KZ 


K2Z11 


K2Z21 


KZ31 


LB 
LB1i1 


LC 
LCi1 


LE 


LEOO 


LEO3 


LEO2 


LF 
LFi1 


LG 
LG11 


EXPAND-MACRO = cKX int 


(Level 2): Invalid macro-number (must be from 
—32768 to -32742, -32740 to -32737, 
-32608 to -32513, or 0 to 32767). 


SET-KEY-EXECUTE-CHAR = ‘ckY int 


(Level 2): Invalid Key-execute-char (must range from 
Oto 127). 


SET-EDIT-CHARS = ®cKZ int int int 


(Level 2): Invalid char-delete character (must range 
from 0 to 127). 


(Level 2): Invalid /ine-delete character (must range 
from 0 to 127). 


(Level 2): Invalid take-literally character (must 
range from 0 to 127). 


SET-DIALOG-AREA-BUFFER-SIZE = cLB int 


(Level 2): Invalid number-of-lines. (Must range from 
2 to 32767.) 


SET-DIALOG-AREA-CHARS = cLC int 


(Level 2): Invalid number-of-chars. (4112, 4113: 5 to 
80; 4114, 4116: 5 to 819; 4115: 5 to 160.) 


END-PANEL = *cLE 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115). 
(Level 1): 
(Level 3): 


No panel is currently being defined. 


Out of memory while performing END- 
PANEL command. 


MOVE = cLF xy 


(Level 2): Invalid position (4112, 4113, 4114, 4116: 
X = 0to 4095, Y = 0 to 4095; 4115: X = 
0 to 4095 or —2°' to 23'-1, Y = Oto 4095 
or —23' to 23'—1.) 


DRAW = ‘cLG xy 


(Level 2): Invalid position (4112, 4113, 4114, 4116: 
X = Oto 4095, Y = Oto 4095; 4115: X = 
0 to 4095 or —23' to 23'-1, Y = 0 to 4095 
or —23' to 23'—1,) 


LH 
LH11 


Li 
LIOO 


Li11 


L121 


LI31 


LJ 


LJOO 


LJ11 


LK 


LKO2 


LK10 


LK11 


LK13 


LL 
LL11 


LM 


DRAW-MARKER = ®cLH xy 


(Level 2): Invalid position (4112, 4113, 4114, 4116: 
X = 0to 4095, Y = Oto 4095; 4115: X = 
0 to 4095 or —23' to 23'-1, Y = 0 to 4095 
or —23' to 23'-1,) 


SET-DIALOG-AREA-INDEX = €cL1 int int int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 2): Invalid character-index. (Range is 0 to 


32767.) 


(Level 2): Invalid character-background-index. 


(Range is 0 to 32767.) 


(Level 2): Invalid wipe-index. (Range is 0 to 32767.) 


SET-DIALOG-AREA-ALTERNATE-INDEX =  cLJ int 


(Level 0): Unrecognized command (terminal is not 
Version 4 or later; only valid for 4112, 
4113, or 4115). 


(Level 2): Invalid index (range is 0 to 65535). 


INCLUDE-COPY-OF-SEGMENT = cLK int 


(Level 3): Out of memory while performing 


INCLUDE-COPY-OF-SEGMENT. (4112, 
4113 and 4115 only). 


(Level 2): 
(Level 2): 


Segment does not exist. 


Invalid segment-number (must be -3, -1, 
or from 1 to 32767.) 


(Level 2): The segment specified is currently being 


defined. 
SET-DIALOG-AREA-LINES = cLL int 
(Level 2): Invalid number-of-lines. (4112, 4113: 2 to 


34; 4114, 4116: 2 to 520; 4115: 2 to 64.) 


SET-DIALOG-AREA-WRITING-MODE = cLM int 


LM1i1 (Level 2): Invalid writing-mode (must be 0 or 1). 


4115B OPERATORS 


LP 
LPOO 


LP02 
LPO 


LP11 


LP21 


LS 


LSOO 


LS11 


LT 


LTO3 


LT11 


LT12 


LV 


LV03 


LV11 


LX 
LX11 


BEGIN-PANEL-BOUNDARY = FcLP xy int 


(Level 0): Unrecognized command. (Terminal is not 
a 4112, 4113, ora 4115.) 


(Level 3): Out of memory while defining panel. 


(Level 2): Alphatext is not allowed within a panel- 
definition. When this error is detected, 
the panel being defined is closed, as if an 
END-PANEL command had been 
received. 


Invalid first-point (4112, 4113: X = Oto 
4095, Y = Oto 4095; 4115: X = 0 to 4095 
or —23' to 23'-1, Y = 0 to 4095 or -—23' to 
231_1), 


(Level 2): 


(Level 2): Invalid draw-boundary-mode (must be 0 


or 1). 


SET-DIALOG-AREA-SURFACE = 5cLS int 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid surface-number. (4112: 1 to 3; 
4113: 1 to 4; 4115: 1 to 8.) 


GRAPHIC-TEXT = ®cLT string 


(Level 2): Command is invalid at this time 
(graphtext is not allowed within a panel- 
definition). 


(Level 2): Invalid array count (must be from 0 to 
65535). 


(Level 2): Out of memory while parsing the 
parameter. 


SET-DIALOG-AREA-VISIBILITY = cLV int 


(Level 0): One or more of the dialog area parame- 
ters was altered when the dialog area was 


made visible. 


(Level 2): Invalid visibility-mode. (Must be 0 or 1.) 


SET-DIALOG-AREA-POSITION = cLX xy 


(Level 2): Invalid position (4115: X or Y out of range 
0 to 4095). 


4115B OPERATORS 


LZ 


ERROR CODES 


CLEAR-DIALOG-SCROLL = *cLZ 


No errors are detected for this command. 


MA 
MAOO 


MA11 


MBOO 


MB11 


MB21 


MC 


MC11 


MC21 


MC31 


MD 


MDOO 


MD02 


MD03 


MD11 


MD21 


MD31 


MD41 


SET-GRAPHTEXT-SLANT = cMA real 


(Level 0): Unrecognized commana; firmware is 
Version 3 or earlier. 


(Level 2): Invalid slant-angle (must range from 
—32767.0 to 32767.0). 


SET-BACKGROUND-INDICES = ‘cMB int int 


(Level 0): Unrecognized commana. (The terminal is 


not a 4112, 4113, or 4115). 


(Level 2): Invalid text-background-index (must 


range from —2 to 32767). 


(Level 2): Invalid dash-gap-index (must range from 


~2 to 32767). 


SET-GRAPHTEXT-SIZE = -cMC int int int 


(Level 2): Invalid value in parameter 1. (4112, 4113, 


4114, 4116: 1 to 4095; 4115: 1 to 29-1.) 


Invalid value in parameter 2. (4112, 4113, 
4114, 4116: 1 to 4095; 4115: 1 to 23'-1.) 


(Level 2): 


Invalid value in parameter 3. (4112, 4113, 
4114, 4116: 0 to 4095; 4115: 0 to 29'-1.) 


(Level 2): 


BEGIN-FILL-PATTERN = cMD int int int int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 3): Not enough memory available for fill 


pattern. 


Another fill pattern is currently being 
defined. 


(Level 2): 


(Level 2): Invalid fill-pattern-number (must range 


from 1 to 32767). 


Invalid pattern-width (4112, 4113: 1 to 32; 
4115: 1 to 1280). 


(Level 2): 


(Level 2): Invalid pattern-height (4112, 4113: 0 to 


480; 4115: 0 to 1024). 


(Level 2): Invalid bits-per-pixel (on the 4112, must 
be 1, 2, 3, or 6; on the 4113, must be 1, 2, 


3, 4, or 6; on the 4115, must be 1 to 8). 


A-13 


ERROR CODES 


ME 
MEOO 


MF 
MF10 
MF 11 


MG 


MGOoOo 


MG11 


Mi 
MIO03 


Ml41 


ML 
ML11 


MM 
MM11 


MP 


MPOO 


MP10 


MP11 


MQ 
MQ11 


END-FILL-PATTERN = -cME 


(Level 2): Unrecognized command. (Terminal is not 
a 4112, 4113, or 4115). 


SET-GRAPHTEXT-FONT = ‘cMF int 
(Level 2): Font is not defined. 


(Level 2): Invalid font-number (must range from 0 to 
32767). 


SET-GRAPHICS-AREA-WRITING-MODE = ©cMG int 


(Level 0): Unrecognized command. (Terminal is not 
a 4112, 4113, or 4115.) 


(Level 2): Invalid writing-mode. (Must be 0 or 1.) 


SET-PICK-ID = cMl int 


(Level 2): Command is invalid at this time. (No seg- 


ment is currently being defined.) 


(Level 2): Invalid pick-number. (Must range from 0 


to 32767.) 


SET-LINE-INDEX =  cML int 


(Level 2): Invalid /ine-index. (Must range from 0 to 
32767.) 


SET-MARKER-TYPE = -cMM int 


(Level 2): Invalid marker-number (must be from 
0 to 10). 


SELECT-FILL-PATTERN = cMP int 


(Level 2): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


(Level 2): Specified fill-pattern has not been 


defined. 


(Level 2): Invalid fill-pattern (must range from 


—32768 to 32767.) 


SET-GRAPHTEXT-PRECISION = cMQ int 


(Level 2): Invalid precision mode (must be 1 or 2). 


MR 
MR11 


MS 


MS00 


MS11 


MS21 


MS31 


MT 
MT 11 


MV 
MV11 


MW 


SET-GRAPHTEXT-ROTATION = cMR real 


(Level 2): Invalid angle-in-degrees (must range from 
-—32767.0 to 32767.0). 


SET-PANEL-FILLING-MODE = *cMS int int int 


(Level 0): Unrecognized command. (Terminal is not 


a 4112, 4113, of 4115.) 


(Level 2): Invalid overstrike/replace mode (must be 


Oor 1). 


(Level 2): Invalid cover-boundary mode (must be 0 


or 1). 


(Level 2): Invalid pattern-keying-mode (must be 


from 0 to 3). 
SET-TEXT-INDEX = -cMT int 
(Level 2): Invalid text-index. (Must range from 0 to 


65535.) 


SET-LINE-STYLE = .cMV int 
(Level 2): Invalid /ine-style. (Must range from 0 to 7.) 


SET-LINE-WIDTH = -cMW int 


MWO0 (Level 0): Unrecognized command. (The terminal is 


nota 4114 or 4116.) 


MW11 (Level 2): Invalid width. (Must be 0 or 1.) 


MY 
MY0O 


MY 11 


MZ 
MZ00 


M211 


M221 


M231 


SELECT-ALPHATEXT-SIZE-GROUP = -cMY int 


(Level 0): Unrecognized command (terminal is nota 
4114 or 4116). 


(Level 2): Invalid group (must be either 0 or 1). 


SET-ALPHATEXT-SIZE = §cMZ int int int 


(Level 0): Unrecognized command. (Terminal is not 
a 4114 or 4116.) 


(Level 2): Invalid size-multiplier (must range from 1 


to 16). 


(Level 2): Invalid inter-character-spacing (must 


range from 0 to 15). 


(Level 2): Invalid interline-spacing (must range from 


0 to 255). 


4115B OPERATORS 


NB SET-STOP-BITS = -cNB int 

NB11 (Level 2): Invalid number-of-stop-bits (must be 1 or 
2). 

NC SET-EOM-CHARS = FcNC int int 

NC11 (Level 2): Invalid EOM-char-1. (Must range from 0 
to 127.) 

NC21 (Level 2): Invalid EOM-char-2. (Must range from 0 
to 127.) 

ND SET-TRANSMIT-DELAY = cND int 

ND11 (Level 2): Invalid transmit-delay. (Must range from 0 
to 65535.) 

NE SET-EOF-STRING =  cNE int-array 

NE11 (Level 2): Invalid EOF-string (must contain from 
0 to 10 characters, with each character 
represented by an int in the range from 
Oto 127). 

NE12 (Level 3): Out of memory while parsing the 
parameter. 

NF SET-FLAGGING-MODE = FchNF int 

NF11 (Level 2): Invalid flagging-mode (must be from 
0 to 4). 

NK SET-BREAK-TIME = ‘cNK int 

NK11 (Level 2): Invalid parameter. (Must range from 0 to 
65535.) 

NL SET-TRANSMIT-RATE-LIMIT = -cNL int 

NL11 (Level 2): Invalid rate-/imit. (Must range from 110 to 
65535.) 

NM  PROMPT-MODE = ‘cNM int 

NM11 (Level 2): Invalid prompt-mode (must be 0, 1,or 2). 

NP SET-PARITY = -cNP int 

NP11 (Level 2): Invalid parity-mode. (Must be from 0 to 4.) 

4115B OPERATORS 


NQ 
NQO1 
NQO02 


NQ11 


NR 
NR11 


NR21 


NS 
NS11 


NS12 


NT 
NT11 


NT12 


NU 
NU11 


OB 
OBOO 


OBO3 


OB11 


ERROR CODES 


SET-QUEUE-SIZE =  cNQ int 
(Level 3): 
(Level 3): 


Not all memory freed from queue. 


Out of memory while performing SET- 
QUEUE-SIZE command. 


Invalid queue-size. (Must range from 1 to 
65535.) 


(Level 2): 


SET-BAUD-RATES = -cNR int int 


(Level 2): Invalid transmit-data-rate. (Must be 1, 50, 
75, 110, 134, 150, 300, 600, 1200, 1800, 
2000, 2400, 4800, 9600, 19200, or 
38400.) 


(Level 2): Invalid receive-data-rate. (Must be 0, 1, 
50, 75, 110, 134, 150, 300, 600, 1200, 
1800, 2000, 2400, 4800, 9600, 19200, or 


38400.) 


SET-PROMPT-STRING = cNS int-array 


(Level 2): Invalid prompt-string. (Must be an array 
holding from 0 to 10 int parameters. Each 
of the items in the array must be an intin 
the range from 0 to 127.) 


(Level 3): Out of memory while parsing the 
parameter. 


SET-EOL-STRING = ‘cNT int-array 


(Level 2): Invalid KOL-string. (The array must hold 
from 0 to 2 int parameters. Each int in the 
array must be in the range from 0 to 127.) 


(Level 3): Out of memory while parsing the 
parameter. 


SET-BYPASS-CANCEL-CHAR = ®cNU int 


(Level 2): Invalid numeric equivalent of bypass- 
cancel-character. (Must range from 0 to 
127.) 


ARM-FOR-BLOCK-MODE = cOB int 


(Level 2): Unrecognized command. (Option 01 is 
not installed.) 


(Level 2): The communications queue size is 
smaller than the specified input block 
size. 


(Level 2): Invalid block-mode-arming parameter 
(must be 0 or 1). 


ERROR CODES 


OC 
OCO00 


OC03 


OC11 


0C13 


0C21 


OC23 


OD 
ODOO 


OD01 


OE 
OEOO 


OE03 


OE11 


OE13 


OE21 


OE23 


SET-BLOCK-CONTINUE-CHARS = cOC int int 


(Level 2): Unrecognized command. (Option 1 is not 
installed.) 


(Level 2): Command is invalid at this time. (Terminal 


must not be armed for block mode.) 


(Level 2): Invalid transmit-continue-char. (Must 


range from O to 127.) 


Transmit-continue-char must be 
different from block-master-char and 
block-end-char. 


(Level 2): 


(Level 2): Invalid receive-continue-char. (Must range 


from O to 127.) 


(Level 2): Receive-continue-char must be 
different from block-master-char and 
block-end-char. 


SET-DUPLEX-MODE = ®cOD int 


(Level 0): Unrecognized command. (Option 01 is 
not installed.) 


(Level 2): Invalid duplex-mode (must be 0 to 3). 


SET-BLOCK-END-CHARS =  cOE int int 


(Level 2): Unrecognized command. (Option 1 is not 
installed.) 


(Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 


(Level 2): Invalid transmit-end-char. (Must range 


from 0 to 127.) 


Transmit-end-char must be 
different from block-master-char and 
block-continue-char. 


(Level 2): 


(Level 2): Invalid receive-end-char. (Must range from 


0 to 127.) 


Receive-end-char must be 
different from block-master-char and 
block-continue-char. 


(Level 2): 


OH 
OHO0 


OH02 


OHO03 


OH11 


OH12 


OH21 


OH22 


OL 


OLOO 


OLO3 


OL11 


OM 


OMOO (Level 2): 


OMO3 (Level 2): 


OM11 


OM13 (Level 2): 


OM21 


OM23 (Level 2): 


SET-BLOCK-HEADERS = cOH int-array int-array 


(Level 2): Unrecognized command. (Option 01 is 
not installed.) 


(Level 3): Out of memory while performing 


command. 


(Level 2): Command invalid at this time. (Terminal 


must not be armed for block mode.) 


(Level 2): Invalid char (must be 0 to 127) or array 
count (must be in range 0 to 10) in 


transmit-header. 


(Level 3): Out of memory while parsing the 


parameter. 


(Level 2): Invalid char (must be O to 127) or array 
count (must be in range 0 to 10) in receive- 


header. 


(Level 3): Out of memory while parsing the 


parameter. 


SET-BLOCK-LINE-LENGTH = *cOL int 


(Level 2): Unrecognized command. (Option 01 not 


installed.) 


Command invalid at this time. (Terminal 
must not be armed for block mode). 


(Level 2): 


(Level 2): Invalid maximum-line-length. (Must range 


from 12 to 65535.) 


SET-BLOCK-MASTER-CHARS = cOM int int 


Unrecognized command. (Option 01 is 
not installed.) 


Command invalid at this time. (Terminal 
must not be armed for block mode.) 


(Level 2): Invalid transmit-master-char (0 to 127). 


Transmit-master-char must be 
different from block-end-char and 


block-continue-char. 
(Level 2): Invalid receive-master-char (0 to 127). 


Receive-master-char must be 
different from block-end-char and 
block-continue-char. 


4115B OPERATORS 


ON SET-BLOCK-NON-XMT-CHARS = cON int-array 

int-array 

ONOO (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

ONO3 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

ON11 (Level 2): Invalid character code or array count in 
transmit-chars. (The array count must be 
from 0 to 20, and the character codes 
must be from 0 to 127.) 

ON12 (Level 3): Out of memory while parsing the 
parameter. 

ON21 (Level 2): Invalid character code or array count in 
receive-chars. (The array count must be 
from 0 to 20, and the character code must 
be from 0 to 127.) 

ON22 (Level 3): Out of memory while parsing the 
parameter. 

OP SET-BLOCK-PACKING = cOP int int int int 

OPOO (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OPO3 (Level 2): Command invalid at this time. (Terminal 
must not be armed for block mode.) 

OP11 (Level 2): Invalid transmit-unpackea-bits (must be 7 
or 8). 

OP21 (Level 2): Invalid transmit-packed-bits (must be 6, 7, 
Or 8). 

OP31 (Level 2): Invalid receive-unpacked-bits (must be 7 
or 8). 

OP41 (Level 2): Invalid receive-packed-bits (must be 6, 7, 
or 8). 

Os SET-BLOCK-LENGTH =  cOS int int 

OSO00 (Level 2): Unrecognized command. (Option 01 is 
not installed.) 

OS03 (Level 2): Command invalid at this time. (Terminal 
must not be or armed for block mode.) 

OS11 (Level 2): Invalid transmit-block-length (must range 
from 5 to 65535.) 

OS21 (Level 2): Invalid receive-block-length (must range 
from 5 to 65535.) 

4115B OPERATORS 


OT 
OTOO 


OT11 


PA 


PAOO 


PA11 


PA12 


PA13 


PA21 


PA22 


PB 
PBOO 


PBi1 


PB12 


PB13 
PB21 


PB31 


ERROR CODES 


SET-BLOCK-TIMEOUT = cOT int 


(Level 2): Unrecognized command. (Option 01 is 
not installed.) 


(Level 2): Invalid timeout. (Must range from 0 to 
65535 seconds.) 


PORT-ASSIGN = cPA device string int 


(Level 0): Unrecognized command. (Option 10 is 


not installed.) 


(Level 2): Invalid port identifier. (Must be PO:, P1:, 


or P2:.) 


(Level 3): Out of memory while parsing the 


parameter 


(Level 2): Portis in use. 


(Level 2): Invalid protocol identifier. (Must be 
PPORT, 4643, 4662, 4662/MP, 4662/NT, 


4663, 4663/NB, 4663/NT, or KATA). 


(Level 3): Out of memory while parsing parameter. 


SET-PORT-STOP-BITS = -cPB device int int 


(Level 0): Unrecognized command. (Option 10 is 


not installed.) 


(Level 2): Port identifier is invalid (must be PO:, P1:, 


or P2:). 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): 
(Level 2): 


Port is busy. 


Invalid number-of-stop-bits (must be 
1 or 2). 


(Level 2): Invalid number-of-data-bits (must be 5, 6, 


7, or 8). 


ERROR CODES 


PC 
PCOO 


PC02 


PC10 
PC11 


PC12 


PC13 


PC21 


PC22 


PC30 


PC31 


PC32 


PC33 


PE 


PEOO 


PE11 


PE12 


PE13 
PE21 


PE22 


PORT-COPY = ‘cPC device string device 


(Level 0): 


(Level 3): 


(Level 2): 
(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


Unrecognized command. (Option 10 is 
not installed). 


Out of memory while processing 
command. 


Source device does not exist. 


Invalid source (must be HO:, PO:, P1:, or 
P2:). 

Out of memory while parsing the 
parameter. 


Source is busy, or is a peripheral port that 
is not assigned the PPORT protocol. 


Invalid separator. (Must be the empty 
string or TO.) 


Out of memory while parsing the 
parameter 


Destination device is not installed. 


Invalid destination (must be HO:, PO:, P1: 
or P2:, and must be different from the 
source port). 


Out of memory while parsing the 
parameter. 


Destination is busy or is a peripheral port 
that is not assigned the PPORT protocol. 


SET-PORT-EOF-STRING =  cPE device int-array 


(Level 0): 


(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 


(Level 3): 


Unrecognized command. (Option 10 is 
not installed). 


Invalid port identifier (must be PO:, P1:, or 
P2:). 

Out of memory while parsing the 
parameter. 

Port is busy. 


Invalid LOF-string. (The int-array must 
have from 0 to 10 elements, and each int 
in the array must be in the range from 0 to 
127.) 


Out of memory while parsing the 
parameter. 


PF 


PFOO 


PF11 


PF12 


PF13 
PF21 
PF31 


PF41 


Pl 
P100 


Pl02 
Plt 


Pl12 


PI13 
Pl21 
PI31 


SET-PORT-FLAGGING-MODE =  cPF device int int 


int 


(Level 0): 


(Level 2): 


(Level 3): 


(Level 2): 
(Level 2): 
(Level 2): 


(Level 2): 


Unrecognized command. (Option 10 is 
not installed.) 


Invalid port identifier (must be PO:, P1:, or 
P2:). 


Out of memory while parsing the 
parameter. 


Port is busy. 
Invalid flagging-mode (must be 0, 1 or 2). 


Invalid GO character (must be in range 0 
to 127). 


Invalid STOP character (must be in range 
0 to 127; if non-zero, must be different 
from the GO character). 


MAP-INDEX-TO-PEN = cP! device int int 


(Level 0): 


(Level 3): 
(Level 2): 


(Level 2): 


(Level 2): 
(Level 2): 
(Level 2): 


Unrecognized command. (Option 10 is 
not installed.) 


No memory is available for the index map. 


Invalid port identifier (must be PO:, P1:, or 
P2:). 


Out of memory while parsing the 
parameter. 


Port is busy. 
Invalid index (must range from —1 to 255). 


Invalid pen-number (must range from 0 to 
255). 


4115B OPERATORS 


PL 
PLOO 


PLO2 


PL11 


PL12 


PL20 
PL21 
PL22 


PL23 


PL29 


PM 
PMO00 


PM11 


PM12 


PM13 


PM22 


PP 


PPOO 


PP11 


PP12 


PP13 
PP21 


PLOT =  cPL string device 


(Level 0): Unrecognized command. (Option 10 is 


not installed.) 


(Level 3): Out of memory while attempting DMA 


transfer (Option 3A only). 


(Level 2): Invalid separator. (Must be the empty 


string or TO.) 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): Destination device not installed. 
(Level 2): 


(Level 3): 


Invalid destination specifier 


Out of memory while parsing the 
parameter. 


(Level 2): Parameter 2 context error. (Device is write 


protected or busy.) 


(Level 2): Device hardware error (disk drive is not 
ready or is write-protected, or DMA block 


transfer error). 


SET-PORT-EOL-STRING = ©cPM device int-array 


(Level 0): Unrecognized command. (Option 10 is 


not installed.) 


(Level 2): Invalid port identifier. (Must be PO:, P1:, 


or P2:.) 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): 
(Level 3): 


Port is busy. 


Out of memory while parsing the 
parameter. 


SET-PORT-PARITY =  cPP device int 


(Level 0): Unrecognized command. (Option 10 is 


not installed). 


(Level 2): Invalid port specifier (must be PO:, P1:, or 


P2:). 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): 
(Level 2): 


Port is busy. 


Invalid parity-mode (must be in range 0 to 
4). 


4115B OPERATORS 


PQ 
PQOO 


PQ11 


PQ12 


PR 


PROO 


PR11 


PR12 


PR13 
PR21 


QB 


QBOO 


QB11 


QD 
QDO00 


QD11 


QN 
QNOO 


QN11 


ERROR CODES 


REPORT-PORT-STATUS = cPQ device 


(Level 0): Unrecognized command. (Option 10 is 


not installed). 


(Level 2): Invalid port identifier (must be PO:, P1:, or 


P2:). 


(Level 3): Out of memory while parsing the 


parameter. 


SET-PORT-BAUD-RATE = cPR device int 


(Level 0): Unrecognized command. (Option 10 is 
not installed). 


(Level 2): Invalid port identifier (must be PQ:, P1:, or 


P2:). 


(Level 3): Out of memory while parsing the 


parameter. 
(Level 2): 
(Level 2): 


Port is busy. 


Invalid baud-rate (must be 50, 75, 110, 
134, 150, 300, 600, 1200, 1800, 2000, 
2400, 3600, 4800, 7200, or 9600). 


SET-COLOR-COPIER-DATA-RESOLUTION = -cQB 

int 

(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid resolution (must be 1 or 2). 


SELECT-HARDCOPY-INTERFACE = cQD int 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid interface (must be 0 or 1). 


SET-NUMBER-OF-COPIES = -cQN int 


(Level 0): Unrecognized command (Option 9 is not 


installed). 


(Level 2): Invalid number-of-copies (must be 0 or 


65535). 


ERROR CODES 


QO 
QO00 


QO11 


QQ 


QQ00 


RA 


RAOO 


RA10 


RA11 


RA21 


RA31 


RB 


RBOO 


RB11 


RC 


RCOO 


RC11 


A-20 


SET-IMAGE-ORIENTATION =  cQO int 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


(Level 2): Invalid orientation (must be from 0 to 3). 


REPORT-COLORHARDCOPY-STATUS = -cQQ 


(Level 0): Unrecognized command (Option 9 is not 
installed). 


SET-VIEW-ATTRIBUTES =  cRA int int int 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Surface does not exist (has not 
been defined with SET-SURFACE- 


DEFINITIONS command). 


(Level 2): Invalid surface-number. (4112: -1 to 3; 


4113: -1 to 4; 4115: -1 to 8.) 


(Level 2): Invalid wipe-index. (Must range from 0 to 


65535.) 


(Level 2): Invalid border-index. (Must range from 0 


to 65535.) 


SET-BACKGROUND-GRAY-LEVEL = *cRB int 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid gray-level (must range from 0 to 
100 or 1000 to 1100). 


SELECT-VIEW = -cRC int 


(Level 0): Unrecognized command. (The terminal is 


not a 4112, 4113, or 4115.) 


Invalid view-number. (Must range from —1 
to 64.) 


(Level 2): 


RD 
RDOO 


RD10 


RD11 


RD12 


RE 


REOO 


RE11 


RF 


RFOO 


RF11 


RG 


RGOO 


RG10 


RG11 


RG21 


RG22 


SET-SURFACE-DEFINITIONS = cRD int-array 


(Level 0): Unrecognized command. (The terminal is 


nota 4112, 4113, or 4115.) 


(Level 2): Occupied undefined surface. (This com- 
mand would have resulted in a dialog 
area viewport, pixel viewport, or num- 
bered graphic viewport residing on an 


undefined surface.) 


(Level 2): Invalid surface-defs array. (4112: array 
count: 1 to 3; ints: 0 to 3; 4113: array 
count: 1 to 4; ints: 0 to 4; 4115: array 


count: 1 to 8; ints: 0 to 8.) 


(Level 3): Out of memory while parsing the 


parameter. 


SET-BORDER-VISIBILITY =  cRE int 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid border-visibility-mode parameter 
(must be 0, 1, or 2). 


SET-FIXUP-LEVEL = ©cRF int 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid fixup-level (must range from 0 to 
32767). 


SET-SURFACE-GRAY-LEVELS =  cRG int int-array 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS commana). 


(Level 2): Invalid surface-number. (4112: —1 or 1 to 


3; 4113: -1 or 1 to 4; 4115: -1 or 1 to 8.) 


(Level 2): Invalid surface-gray-levels array. (The 
array count must be even; the first int in 
each pair must be a color index in the 
range from 1 to 32767; the second int in 
each pair must be a valid gray-level: a 


number from 0 to 100 or 1000 to 1100.) 


(Level 3): Out of memory while parsing the 


parameter. 


4115B OPERATORS 


RH SET-PIXEL-BEAM-POSITION =  cRH xy 

RHOO (Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 

RH11 (Level 2): Invalid beam-position (4115: -23' to 
23114), 

RI SET-SURFACE-VISIBILITY = cRI int-array 

RIOO (Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 

R!I10 (Level 2): A surface in surface-numbers-and-visibili- 
ties does not exist (has not been defined 
with a SET-SURFACE-DEFINITIONS 
commandq). 

Rl1i (Level 2): Invalid surface-numbers-and-visibilities 
array. (Surface numbers: 4112: 1 to 3; 
4113: 1 to 4; 4115: 1 to 8. Visibility: 0 to 2 
for all terminals. Array count must be 
even and range from 2 to 65534.) 

Rl12 (Level 3): Out of memory while parsing the 
parameter. 

RJ LOCK-VIEWING-KEYS = cRuJ int 

RJOO (Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 

RJ11 (Level 2): Invalid /ocking-mode (must be 0 or 1). 

RK DELETE-VIEW = ©cRK int 

RKOO (Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 

RK10 (Level 1): The designated view does not exist (has 
not been defined with a SELECT-VIEW 
command). 

RK11 (Level 2): Invalid view-number (must range from —1 
to 64). 

4115B OPERATORS 


RL 
RLOO 


RL11 


RL12 


RN 
RNOO 


RN10 


RN11 


RN12 


RP 


RPOO 


RP11 


RP21 


RP22 


RQ 
RQO0 


RQ11 


RQ12 


ERROR CODES 


RUNLENGTH-WRITE = cRL int-array 


(Level 2): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid runlength-code array. (The array 
count must range from 0 to 65535, and 
each int in the array must also range from 
0 to 65535 on a 4112 and 4113, and from 


0 to 23'-1 on a 4115.) 


(Level 3): Out of memory while parsing the parame- 


ter, or while executing the command. 


SET-SURFACE-PRIORITIES = cRN int-array 


(Level 0): Unrecognized command. (The terminal is 
not a4112, 4113, or 4115.) 


Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS commana). 


(Level 2): 


(Level 2): Invalid priorities array. (Surfaces: 4112: 1 
to 3; 4113: 1 to 4; 4115: 1 to 8. Priorities: 


4112: 0 to 4; 4113: Oto 5; 4115: Oto 9.) 


(Level 3): Out of memory while parsing the 


parameter. 


RASTER-WRITE = ©cRP int char-array 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


(Level 2): Invalid number-of-pixels. (Must range 


from 0 to 65535.) 


(Level 2): There are too many or too few pixels in 
the code-array, or invalid codes are 


present (range for codes is ADE 32 to 96). 


(Level 3): Out of memory while parsing the 


parameter. 


SET-VIEW-DISPLAY-CLUSTER = cRQ int-array 


(Level 0): Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115). 


(Level 2): Invalid view-numbers array. (Each view 
number must range from —2 to 64; array 


count must be from 0 to 65535.) 


(Level 3): Out of memory while parsing the 


parameter. 
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ERROR CODES 


RR 
RROO 


RR11 
RR21 
RR31 
RS 


RSOO 


RS11 


RS21 


RT 
RTO0O 


RT11 
RT21 
RT31 
RU 
RUOO 


RU10 


RU11 
RU21 


RU31 


A-22 


RECTANGLE-FILL = -cRR xy xy int 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


Invalid first-corner. (4112, 4113: X = Oto 
639, Y = 0to 479; 4115: X = 0to 1279, Y 
= Oto 1023.) 


Invalid second-corner. (4112, 4113: X = 0 
to 639, Y = 0 to 479; 4115: X = Oto 1279, 
Y = Oto 1023.) 


Invalid fi/l-index (must range from 0 to 
65535.) 


SET-PIXEL-VIEWPORT = §cRS xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


Invalid first-corner. (4112, 4113: X = Oto 
639, Y = 0to 479; 4115: X = Oto 1279, Y 
= Oto 1023.) 


Invalid second-corner. (4112, 4113: X = 0 
to 639, Y = Oto 479; 4115: X = Oto 1279, 
Y = Oto 1023.) 


SET-PIXEL-WRITING-FACTORS =  cRT int int int 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (Terminal is not 
a 4115.) 


Invalid pixel-width parameter (range is 
—1280 to 1280). 


Invalid pixel-height parameter (range is 
—1280 to 1280). 


Invalid major-axis parameter (must be 0 
or 1). 


BEGIN-PIXEL-OPERATIONS =  cRU int int int 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115.) 


Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 


Invalid surface-number. (4112: -1 to 3; 
4113: -1 to 4; 4115: -1 to 8.) 


Invalid AL U-mode (4112, 4113: 0 to 16; 
4115: 0, 7,11, 12, 15, 17, or 18). 


Invalid bits-per-pixel. (4112: 0, 1, 2, 3, or 
6; 4113: 0, 1, 2, 3, 4, or 6; 4115: 0 to 8.) 


RV 
RV0O 


RVO1 


RV11 


RV21 


RW 
RW00 


RWO01 


RW11 


RW21 


RX 
RX00 


RX10 


RX11 


RX21 


RX31 


RX41 


SET-VIEWPORT = —cRV xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


Invalid viewport size. (In the 4112 and 
4113, the viewport must not be more 
than 51.2 times larger than the current 
window.) 


Invalid first-corner. (4112, 4113: X = Oto 
4095, Y = 0to 3071; 4115: X = Oto 
4095, Y = 0to 3276.) 


Invalid second-corner. (4112, 4113: X = 0 
to 4095, Y = 0to 3071; 4115: X = Oto 
4095, Y = 0t0 3276.) 


SET-WINDOW = FcRW xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


Invalid window size. (In the 4112 and 
4113, the viewport must not be more 
than 51.2 times larger than the current 
window.) 


Invalid first-corner (4112, 4113: X = Oto 
4095, Y = Oto 4095; 4115: X = Oto 4095 
or —23' to 23'-1, Y = 0 to 4095 or -23' to 
231_1). 


Invalid second-corner (4112, 4113: X = 0 
to 4095, Y = Oto 4095; 4115: X = Oto 
4095 or —2°' to 23'-1, Y = Oto 4095 or — 
231 to 

231.4), 


PIXEL-COPY = cRX int xy xy xy 


(Level 0): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


(Level 2): 


Unrecognized command. (The terminal is 
nota 4112, 4113, or 4115.) 


The specified destinatior-surface does 
not exist. 


Invalid destination-surface. (4112: —1 to 3; 
4113: -1 to 4; 4115: -1 to 8.) 


Invalid destination-lower-left-corner. 
(4112, 4113: X = 0to 639, Y = 0 to 479; 
4115: X = 0to 1279, Y = Oto 1023.) 


Invalid first-source-corner. (4112, 4113: 
X = 010639, Y = 0to 479; 4115: X = 0 
to 1279, Y = Oto 1023.) 


Invalid second-source-corner. (4112, 
4113: 

X = 0to 639, Y = 0to 479; 4115: X = 0 
to 1279, Y = Oto 1023.) 


4115B OPERATORS 


SA 
SA03 


SA10 
SA11 


SA21 


SA22 


SA31 


SA32 


SB 


SBOO 


SBOO 
SBO1 


SB02 


SB03 


Sc 
SC02 


SC03 


SD 
SDO03 


SD10 
SD11 


sD21 


SET-SEGMENT-CLASS =  cSA int int-array int-array 


(Level 2): 


(Level 2): 
(Level 2): 


(Level 2): 


(Level 3): 


(Level 2): 


(Level 3): 


Command invalid at this time: the speci- 
fied segment is currently being defined. 


Segment does not exist. 


Invalid segment-number. (Must be in the 
range from —3 to —1, or from 1 to 32767.) 


Invalid removal-array. (Each class num- 
ber must be -1 or from 1 to 64; array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


Invalid addition-array. (Each class num- 
ber must be —1 or from 1 to 64; array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


BEGIN-LOWER-SEGMENT =  cSB 


(Level 0): 


(Level 2): 
(Level 2): 


(Level 3): 


(Level 2): 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


The indicated segment already exists. 


Invalid for next lower segment number 
(current segment ID is 1). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


Context error; command is invalid at this 
time. No segment is currently being 
defined, or a graphtext character is cur- 
rently being defined. 


END-SEGMENT = -cSC 


(Level 3): 


(Level 1): 


Out of memory while performing com- 
mand (4112, 4113, 4115 only). 


Invalid at this time: no segment is cur- 
rently being defined. 


SET-SEGMENT-DETECTABILITY =  cSD int int 


(Level 2): 


(Level 2): 
(Level 2): 


(Level 2): 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range from 
—3 to -1, or 1 to 32767). 


Invalid detectability (must be 0 or 1). 


4115B OPERATORS 


SE 
SE00 


SE02 


SE 


SE00O 


SE02 


SE03 


SE10 
SE11 


SG 

SG02 
SG10 
SG11 


SG21 


SG31 


SH 


SHO03. 


SH10 


SH11 


SH21 


ERROR CODES 


BEGIN-NEW-SEGMENT = €cSE int 


(Level 0): 


(Level 3): 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


BEGIN-NEW-SEGMENT = ©cSE int 


(Level 0): 


(Level 3): 


(Level 2): 


(Level 2): 
(Level 2): 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


Command is invalid at this time (a 
graphtext character or a panel is currently 
being defined without a segment being 
defined). | 


Segment already exists. 


Invalid segment-number (1 through 32767 
are valid). 


SET-GRAPHTEXT-FONT-GRID = cSG int int int 


(Level 3) 
(Level 2) 
(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while defining font grid. 
Font already exists. 


Invalid font-number (must range from 0 to 
32767). 


Invalid grid-width. (Must range from 1 to 
4095.) 


Invalid grid-height. (Must range from 1 to 
4095.) 


SET-SEGMENT-HIGHLIGHTING = ©cSH int int 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range from 
—3 to -1, or from 1 to 32767). 


Invalid highlighting (must be 0 or 1). 
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ERROR CODES 


Sl 


$l02 


Sl03 


S110 


Sli 


Sl21 


S/31 


3141 


S151 


SK 


SKO2 


SK10 


SK11 


SK13 
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SET-SEGMENT-IMAGE-TRANSFORM = ©cSI int 
real real real xy 


(Level 3) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while transforming 
segment. 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range —3 to 
—1, or 1 to 32767). 


Invalid x-scale-factor. (Must range from 
—32767.0 to 32767.0.) 


Invalid y-scale-factor. (Must range from 
—32767.0 to 32767.0.) 


Invalid rotation-angle. (Must range from 
—32767.0 to 32767.0.) 


Invalid position. (4112, 4113, 4114, 4116: 
X = Oto 4095, Y = Oto 4095; 4115: X = 
0 to 4095 or —2°' to 23'-1; Y = Oto 4095 
or —23' to 231-1.) 


DELETE-SEGMENT = ®cSK int 


(Level 3) 


(Level 1) 


(Level 2) 


(Level 2) 


Out of memory while attempting to delete 
a segment (4112, 4113. 4115 only). 


Segment does not exist. 


Invalid segment-number (must be -3, -1, 
or from 1 to 32767). 


Segment specified is an active 
GIN-cursor. 


SL 


SL11 


SL12 


SL21 


SL22 


SM 


SMO3 


SM10 


SM11 


SM21 


SN 


SNOO 


SNOO 


SNO1 


SNO2 


SNO3 


SET-CURRENT-MATCHING-CLASS =  cSL int- 
array int-array 


(Level 2) 


(Level 3) 


(Level 2) 


(Level 3) 


Invalid inclusion-set. (Class numbers 
must be —1, or from 1 to 64; the array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


Invalid exclusion-set. (Class numbers 
must be -1, or from 1 to 64; the array 
count must be from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


SET-SEGMENT-WRITING-MODE =  cSM int int 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Command is invalid at this time. (The 
specified segment is currently being 
defined. 


Segment does not exist. 


Invalid segment-number (must range from 
—3 to 32767). 


Invalid writing-mode (must be 0 or 1). 


BEGIN-HIGHER-SEGMENT = ©cSN 


(Level 0) 


(Level 2) 


(Level 2) 


(Level 3) 


(Level 2) 


Unrecognized command (the terminal 
firmware is version 1 or 2). 


The indicated segment already exists. 


Invalid for next higher segment number 
(current segment ID is 32767). 


Not enough memory to begin segment, or 
out of memory while ending segment. 


No segment is currently being defined, or 
a graphtext character is currently being 
defined. 
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sO 


S002 


S003 


SO10 


SO11 


SP 


SP11 


SQ 


SQ10 


SQ11 


SQ21 


SQ22 


BEGIN-SEGMENT =  cSO int 


(Level 3) 


(Level 2) 


(Level 2) 


(Level 2) 


Not enough memory to begin segment, or 
out of memory while defining segment. 


Another segment, a graphtext character, 
or a panel is currently being defined. 


Segment already exists. 


Invalid segment-number (must range from 
1 to 32767). 


SET-PIVOT-POINT = =cSP xy 


(Level 2) 


Invalid pivot-point (4115: X and Y must 
be from —23' to 23'—-1),. 


REPORT-SEGMENT-STATUS = £cSQ int char-array 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 3) 


Segment does not exist. 


Invalid segment-number (must range from 
-3 to 32767). 


Invalid array of codes. (Must include only 
the uppercase letters A, D, H,!,M, PS, V, 
and X. Also, the array count must be in 
the range from 0 to 65535.) 


Out of memory while parsing the 
parameter. 


4115B OPERATORS 


SR 


SRO2 


SRO3 


SR10 


SR11 


SR20 


SR21 


ss 


$S03 


SS$10 


SS11 


$s21 


ERROR CODES 


RENAME-SEGMENT = ©cSR int int 


(Level 3) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while renaming a segment 
(4114, 4116 only). 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid old-segment-number (must range 
from 1 to 32767). 


A segment with the o/d-segment-number 
already exists. 


Invalid new-segment-number (must range 
from 1 to 32767). 


SET-SEGMENT-DISPLAY-PRIORITY = cSS int int 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segrnent-number (must range from 
—3 to -1, or from 1 to 32767). 


Invalid priority-number (must range from 
—32768 to 32767). 
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ERROR CODES 


ST 


ST02 


ST03 


ST10 


ST11 


ST20 


ST21 


SU 


SU03 
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BEGIN-GRAPHTEXT-CHARACTER =  cST int int 


(Level 3) Out of memory while defining graphtext 
character, or not enough memory to begin 
the definition. 


(Level 2) Command is invalid at this time. (A 
graphtext character is currently being 
defined.) 


(Level 2) The font specified has no grid defined for 
it. 


(Level 2) Invalid font number (the range is from 0 to 
32767). 


(Level 2) The character specified has already been 
defined in this font. 


(Level 2) Invalid character number (the range is 
from 32 to 126). 


END-GRAPHTEXT-CHARACTER =  cSU 


(Level 1) This command is invalid at this time. (No 
graphtext character is being defined.) 


SV 


SV02 


SV03 


SV10 


SvV11 


SsV21 


SX 


SX02 


SX03 


SX10 


SX11 


SX21 


SET-SEGMENT-VISIBILITY =  cSV int 


(Level 3) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while performing com- 
mand (4112, 4113, 4115 only.) 


Command is invalid at this time. (The 
specified segment is currently being 
defined.) 


Segment does not exist. 


Invalid segment-number (must range from 
—3 to 32767). 


Invalid visibility (must be O or 1). 


SET-SEGMENT-POSITION =  cSxX int xy 


(Level 3) 


(Level 2) 


(Level 2) 


(Level 2) 


(Level 2) 


Out of memory while performing com- 
mand. 


Command is invalid at this time (the spec- 
ified segment is currently being defined; 
4112, 4113, 4115 only). 


Segment does not exist. 


Invalid segment-number (must range from 
—3 to 32767.) 


Invalid position (4112, 4113, 4114, 4116: 
X = 0to 4095, Y = Oto 4095; 4115: X = 
0 to 4095 or -23' to 23'-1; Y = Oto 4095 
or —23' to 23'-1,) 


4115B OPERATORS 


SZ 


$Z03 


$Z10 


SZ11 


$Z20 


$Z21 


TB 


TBOO 


TB11 


TB21 


TB31 


DELETE-GRAPHTEXT-CHARACTER = cSZ int int 


(Level 2) 


(Level 1) 


(Level 2) 


(Level 1) 


(Level 2) 


Command is invalid at this time. (A 
graphtext character is currently being 
defined.) 


The specified font does not exist (no grid 
has been defined for that font). 


Invalid font-number (must range from —1 
to 32767). 


The character specified does not exist in 
this font. 


Invalid char-number. (Must be —1, or from 
32 to 126.) 


SET-BACKGROUND-COLOR = cTB int int int 


(Level 0) Unrecognized command (terminal is nota 


(Level 2) 


(Level 2) 


(Level 2) 


4112, 4113, or 4115). 


Invalid first-color-coordinate. (HLS mode: 
—32768 to 32767; RGB and CMY modes: 
0 to 100; 4115 Machine RGB mode: 0 to 
255.) 


Invalid second-color-coordinate (HLS, 
RGB, and CMY modes: 0 to 100; 4115 
Machine RGB mode: 0 to 255). 


Invalid third-color-coordinate (HLS, RGB, 
and CMY modes: 0 to 100 and 1000 to 
1100; 4115 Machine RGB mode: 0 to 255 
and 1000 to 1255). 


4115B OPERATORS 


TG 


TGOO (Level 0) 


TG10 (Level 2) 


TG1i1 (Level 2) 


TG21 (Level 2) 


TG22 (Level 3) 


ERROR CODES 


SET-SURFACE-COLOR-MAP =  cTG int int-array 


Unrecognized command. (The terminal is 
not a 4112, 4113, or 4115). 


Surface does not exist (has not been 
defined with a SET-SURFACE-DEFINI- 
TIONS command). 


Invalid surface-number. (4112: -1, 1 to 3; 
4113: -1, 1 to 4; 4115: -1, 1 to 8). 


Invalid color-mixtures array. (The array 
count must be a multiple of four in the 
range from 0 through 65532. The first int 
in each group be from 0 to 32767. The 
other three ints must be valid HLS, RGB, 
or CMY values, according to the most 
recent SET-COLOR-MODE command. If 
the HLS system is in effect, the Hue 
parameter must be in the range from 
—32768 to + 32767, while the Lightness 
and Saturation parameters must be in the 
range from 0 to 100. If the RGB or CMY 
system is in effect, then the first two color 
coordinates must be in the range 0 to 100, 
and the third color coordinate must be in 
the range from 0 to 100 or 1000 to 1100. 
Ina 4115, if the Machine RGB system is 
in effect, the first two color coordinates 
must be in the range from 0 to 255, and 
the third color coordinate must be in the 
range from 0 to 255 or 1000 to 1255.) 


Out of memory while parsing the 
parameter. 
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ERROR CODES 


TM 


TMOO 


TM11 


TM21 


TM31 


UB 


UBOO 


UB11 


UR 


UROO 


UR11 


UR12 
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SET-COLOR-MODE = cTM int int int 


(Level 0): Unrecognized command (terminal is nota 


4112, 4113, or 4115). 


Invalid color-specify-mode (4112, 4113: 0 
to 3; 4115: 0 to 4). 


(Level 2): 


Invalid color-overlay-mode (must range 
from 0 to 3). 


(Level 2): 


(Level 2): Invalid gray-mode (must be 0, 1, or 2). 
SET-DRAW-BOUNDARY-MODE =  cUB int 


(Level 0) Unrecognized command. (Terminal is not 
a 4115.) 


Invalid draw-boundary-mode (must be 0 
or 1). 


(Level 2) 


DRAW-RECTANGLE = £cUR xy-array 


(LevelO) Unrecognized command. (Terminal is not 
a 4115.) 


(Level 2) Invalid opposite-corners array. (There 
must be an even number of xys in the 
array. Each xy must range from —2°" to 
23'_1; array length must be from 0 to 


65535.) 


(Level 3) Out of memory while parsing the 


parameter. 


UX 


UX00 (Level 0) 
UX11 (Level 2) 
UX21 


(Level 2) 


UW 


UWOO (Level 0) 


UW11 (Level 2) 


UWe1 (Level 2) 


SET-COORDINATE-MODE = ‘cUX int 


Unrecognized command. (Terminal is not 
a 4115.) 


Invalid coordinate-mode (must be 0, 1, 
or 2). 


Invalid int-report-size (must be 0, 
or 2 to 6). 


SET-OVERVIEW-WINDOW = ®cUW xy xy 


Unrecognized command. (Terminal is not 
a 4115.) 


Invalid absolute-lower-left parameter 
(both X and Y must be —2*' to 23'—1). 


Invalid absolute-upper-right parameter 
(both X and Y must be —23' to 23'—1). 


4115B OPERATORS 


ANSI ERROR CODES 


%! 


SELECT-CODE = *c%! int 


%!00 (Level O) Unrecognized command; terminal firm- 
ware is Version 3. 

%!11 (Level 2) Invalid command-set (must be O or 1.) 

[@ INSERT-CHARACTER = CS/ Pn @ 

[@11 (Level 2) Invalid number-of-characters parameter 
(range is 0 to 32767). 

[A CURSOR-UP = CS/PnA 

[A11 (Level 2) Invalid number-of-lines parameter (range 
is 0 to 32767). 

[B CURSOR-DOWN = CS/7PnB 

[B11 (Level 2) Invalid number-of-lines parameter (range 
is O to 32767). 

[C CURSOR-FORWARD = CS/PnC 

[C11 (Level2) Invalid number-of-columns parameter 
(range is 0 to 32767). 

[D CURSOR-BACKWARD = CS/PnD 

[D11 (Level2) Invalid number-of-columns parameter 
(range is 0 to 32767). 

[f HORIZONTAL-AND-VERTICAL-POSITION 

= CS7PnPnf 

[f11  (Level2) Invalid /ine-number parameter (range is 0 
to 32767). 

[f21 (Level2) Invalid column-number parameter (range 
is 0 to 32767). 

4115B OPERATORS 


Ig 


[g11 


[H 


[H11 


[H21 


[h 


[ni 


[! 


[111 


[J 


[J11 


[K11 


[L 


[L11 


[141 


ERROR CODES 


TABULATION-CLEAR = CS7Psg 


(Level 2) Invalid tab-clear-extent parameter. (must 


be 0, 1, or 2). 


CURSOR-POSITION = CS/PnPnH 


(Level 2) Invalid /ine-number parameter (range is 0 


to 32767). 


(Level 2) Invalid column-number parameter (range 


is 0 to 32767) 
SET-MODE = CS/PsPs...h 
(Level 2) Invalid mode value. 
CURSOR-HORIZONTAL-TAB = CS/Pn I 
(Level 2) Invalid value (range is 0 to 32767). 


ERASE-IN-DISPLAY = CS/Ps J 


Invalid erase-extent parameter (must be 0, 
1, Or 2). 


(Level 2) 


ERASE-IN-LINE = CS/ PSK 


(Level 2) Invalid erase-extent parameter (must be 0, 


1, Or 2). 


INSERT-LINE = CS7PnL 


(Level 2) Invalid number-of-lines parameter (range 


is 0 to 32767) 


RESET-MODE = CS/Ps Ps... | 


(Level 2) Invalid mode value. 
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ERROR CODES 


[M 


[M11 


[m 


[m1 1 


[n 


[n11 


[P 


[P11 


[s 


[S11 


[T 


[111 


[X 


[X11 


[Z 


[211 
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DELETE-LINE = CS7PnM 


Invalid number-of-lines parameter (range 
is 0 to 32767). 


(Level 2) 


SELECT-GRAPHIC-RENDITION = CS/PsPs...m 


(Level 2) Invalid rendition parameter (must be 0, 1, 


4,5, or 7). 


DEVICE-STATUS-REPORT = CS7Psn 


(Level 2) Invalid device parameter (the only valid 


device specifier is 6). 


DELETE-CHARACTER = CS/ PnP 


(Level 2) Invalid number-of-characters parameter 


(range is 0 to 32767). 


SCROLL-DOWN = CS7PnS 


(Level 2) Invalid number-of-lines parameter (range 


is 0 to 32767). 


SCROLL-DOWN = CS7PnT 


(Level 2) Invalid number-of-lines parameter (range 


is 0 to 32767). 


ERASE-CHARACTER = CS/ Pn X 


(Level 2) Invalid number-of-characters parameter 


(range is 0 to 32767). 


CURSOR-BACKWARD-TAB = CS/ Pn Z 


(Level 2) Invalid number-of-tabs parameter (range 


is 0 to 32767). 


b ENABLE-MANUAL-INPUT = cb 


No errors are detected for this command. 


c RESET-TO-INITIAL-STATE = cc 


No errors are detected for this command. 


D INDEX = cD 


No errors are detected for this command. 


E NEXT-LINE = cE 


No errors are detected for this command. 


H HORIZONTAL-TAB-SET = -cH 


No errors are detected for this command. 


M REVERSE-INDEX = cM 


No errors are detected for this command. 


7 RESTORE-CURSOR = *c7 


No errors are detected for this command. 


8 RESTORE-CURSOR = *c8 


No errors are detected for this command. 


: DISABLE-MANUAL-INPUT = c‘ 


No errors are detected for this command. 
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Appendix B 


POWER-UP SEQUENCE AND SELF-TEST 


This appendix explains the messages that can appear on 
the screen during the power-up sequence if a problem is 
detected. It also explains how to use the terminal’s exten- 
sive self-test procedure. 


THE POWER-UP SEQUENCE 


Each time you turn the terminal on, it automatically tests 
parts of its memory and circuitry. This is called the power-up 
sequence. \t takes from 15 to 60 seconds, depending on 
what options your terminal has, and requires no operator 
interaction. 


During the power-up sequence, the lights in the keyboard 
go through the following sequence: 


All lights turn on. 

The Caps Lock light turns off. 

All other lights turn off. 

The XMT and RCV lights flash once simultaneouly. 


ot ee I 


All lights turn off. 


If the terminal bell does not ring during the power-up 
sequence (within 60 seconds of turning the terminal on), 
press the Page key. The screen is erased and the cursor 
flashes in the upper-left corner of the screen. If the dialog 
area is enabled, the light in the DIALOG key is on and the 
Cursor appears on the first available line of the the dialog 
area. As soon as the cursor appears on the screen, the ter- 
minal is ready for use. 
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If the power-up sequence detects an error, the terminal bell 
rings one, two, or three times, depending on the severity of 
the problem. There may also be a message on the screen. 


If the power-up sequence encounters an error that will not 
prevent you from using the terminal (a non-fatal error), the 
bell rings one time and a message is displayed on the 
screen. 


If the bell rings twice, more information is available. See the 
submessages discussion later in this section. 


If the bell rings three times, a fatal error has occurred. Fur- 
ther use of the terminal is not possible until the error is cor- 
rected. See the Fatal Errors discussion later. 


POWER-UP ERROR 


An example of a power-up error occurs when a problem 
exists that prevents you from using one of the terminal’s 
options. If this happens, the bell rings once and a message 
is displayed. For example, if the disk option failed the 
power-up sequence, the following message would appear: 


ROM Set: 42-Fail 


If there is a problem with a tablet option, the following mes- 
sage appears: 


ROM Set: 13-Fail 


When an option fails, that option cannot be accessed but 
the rest of the terminal’s features can still be used. You can 
report the failure to a service person, or run the self-test pro- 
cedure (described later in the appendix) to isolate the failure 
more specifically. 
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If an error occurs when the terminal is checking its key- 
board, the following message can appear: 


Keyboard!l-D — XX 


where XX is a keyboard ID value. If this occurs, record the 
message and contact a service person. 


The terminal has a setup memory, which remembers many 
of the terminal’s parameters or settings after it is turned off. 
These attributes are reinstated the next time the terminal is 
turned on. If that memory fails, the terminal bell rings once 

and the following message appears on the screen: 


Setup Defaults Reset 


This occurs if the terminal’s configuration has been altered 
by putting in or taking out a circuit board. It also occurs if the 
battery that powers the setup memory fails. If the setup 
memory battery fails, all parameters are reset to default. 


FATAL ERRORS 


If the power-up Sequence encounters a fatal error, then the 
terminal is not operational. If that happens, the terminal bell 
rings three times. If the power-up sequence encounters a 
fatal error before the screen is checked, the terminal bell 
rings three times and the keyboard lights will indicate a 
code for the test that failed. 


If this occurs, record the light pattern and report it to a quali- 
fied service technician. You may also want to run the self- 
test procedure, explained later in this section, which 
provides more detailed information that you can relay to a 
qualified service technician. 


When there is a fatal error, the terminal cannot be operated 
except to run the self-test procedure. 
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SELF-TEST 


GENERAL SELF-TEST 


The power-up sequence is an abbreviated test of the termi- 
nal’s memory and circuitry. 


A more extensive test of the terminal’s operating conditions 
is initiated by the SELF TEST button. Self-test thoroughly 
tests the terminal and allows a service technician to make 
any necessary adjustments. 


If the terminal detects an error in the power-up sequence, 
you can run the self-test procedure to isolate the problem. 
You can then report the specific problem to a technician. 


Self-test is initiated by pressing the SELF TEST and MAS- 
TER RESET buttons (Figure B-1) in the following sequence: 


1. Press SELF TEST. 


2. Continue to hold SELF TEST while you press and 
release MASTER RESET. 


3. Continue to hold SELF TEST until the keyboard indica- 
tor lights begin to cycle. 


4. Release SELF TEST. 


Approximately 20 seconds after SELF TEST begins, the 
keyboard bell will ring once. Press any keyboard key to con- 
tinue, or wait 20 seconds and the test continues automati- 
Cally. 


During self-test, the keyboard light patterns continue to 
change as tests are run. If a module fails, the terminal bell 
rings twice, the Caps Lock light begins to blink, and a light 
pattern remains on for 20 seconds, indicating which test has 
failed. Record that pattern to report to a technician. 
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Submessages 


In addition to this intial light-coded message, many mes- 
sages have up to three submessages which can provide a 
technician with even more information about the problem. 


If you want to view the submessages, start the following 
sequence within 20 seconds after the initial message 
appears. (If you take no action within 20 seconds, the sub- 
messages will appear at 20-second intervals.) 


1. Press the Rtn key or Space bar. 


2. Theterminal bell rings twice and another light pattern is 
displayed. 

3. Record the light pattern and press Rtn or the Space bar 
again. 

4. I\fthere is another submessage, the bell rings twice and 
another light pattern is displayed. 


5. Record the light pattern and press Rtn or the Space 
bar. 
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6. Ifthere is a third submessage, the bell rings twice and 
another light pattern is displayed. 


7. Record the light pattern and press Rtn or the Space 
bar. 


8. When you have seen all of the submessages, there is 
no bell when you press Rtn or the Space bar, the light in 
the Caps Lock key stops blinking, and the indicator 
light pattern changes to indicate that the next test in the 
self test procedure is being run. 


Most error messages are displayed in this manner as the 
terminal checks its display. After the display has been 
checked, option error messages are displayed on the 
screen as well as by light patterns. If the test halts at this 
point, it is because the screen is filled with error messages. 
Make a hard copy or write down the error messages. Press 
the Page key and the test will continue. 


The self-test procedure is explained in more detail in Vol- 
ume 2 of the 4//5B Service Manual. 








SELF MASTER 
TEST RESET 
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Figure B-1. The MASTER RESET and SELF TEST Buttons. 
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Appendix C 


ESCAPE SEQUENCE COMMANDS 


The commands that the operator most commonly uses have 
an English-like format and are called setup commands, as 
explained in Section 6. 


However, the terminal can execute many more commands, — 


which are issued in a format called escape sequences. They 
are called escape sequences because the first character in 
the command is always an ASCII escape character. All ter- 
minal commands (including setup commands and com- 
mand keys) have an escape sequence format. 


Although escape sequences are primarily used by the host 
to send commands to the terminal, you can enter an escape 
sequence from the terminal as well, in either Setup or Local 
modes. The escape sequences are entered in a slightly dif- 
ferent format for each of the two modes. 


This appendix briefly discusses escape sequence com- 
mands and lists the format for each. See the 4/10 Series Host 
Programmers Manual and the 4110 Series Command Refer- 
ence Manual for details on the use of escape sequences. 


TWO FORMATS 


There are two different formats for escape sequence 
commands. 


One format consists of the escape character followed by a 
single-character op code. Escape sequences in this format 
can only be entered in Local mode. In a general form, this 
could be represented as follows: 

EcX 


(Fc represents the escape character, X represents a single 
ASCIl character.) 
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The second format consists of the escape character fol- 
lowed by a two-character op code and sometimes one or 
more parameters. Escape sequences in this format can be 
entered in either Local or Setup modes, though they are 
entered differently in each mode. This format could be rep- 
resented as follows: 


ECXX parameter parameter... 


The c represents the escape character. Each X represents 
a single ASCII character. Each parameter can be an ASCII 
character, a string of ASCII characters, or a real number. 


ESCAPE SEQUENCES 
IN SETUP MODE 


All escape sequence commands that consist of the escape 
character followed by a two-character op code can be exe- 

cuted in Setup mode. The following list details the format of 
escape sequences in Setup mode: 


@ The first character in the command is the escape charac- 
ter (ASCII 27). 


@ All alphabetic characters must be upper case. 


@ There is no space between the escape character and the 
two-character op code of the command. 


@ If the command has parameters, enter one or more 
spaces after the op code and then enter the parameters 
with one or more spaces between each parameter. 


@ Enter keyword parameters in their English-like format; 
enter numeric values in the normal way (special encod- 
ing is not necessary as it is in Local mode). 


® Terminate the command with a carriage return (CR) which 
causes the command to be executed. 


C-1 


ESCAPE SEQUENCE COMMANDS 


For example, if the dialog area is enabled but not visible, 
you can press the DIALOG key to make the dialog area visi- 
ble. However, there is also an escape sequence command 
that makes the dialog area visible. 


You can execute that command in Setup mode as follows: 


1. Put the terminal into Setup mode. If the light in the SET 
UP key is on, the terminal is already in Setup mode. If it 
is not on, press the SET UP key and the light turns on 
as the terminal enters Setup mode. 


2. The terminal should not be in Local mode. The light in 
the LOCAL key should be off; if it is on, press the key 
and the light will go off as the terminal leaves Local 
mode. 


3. The light in the Caps Lock key should be on, indicating 
that the key is active and all alphabetic characters will 
be in upper case. 


4. Enter the following command: 
EcLV YESCR 


That is,-press the Esc, L, and V keys with no 
spaces between them. Then press the Space bar, 
enter the keyword YES, and press the Rtn key. The 
characters are echoed on the screen as you enter 
them and the command is executed when you enter 
the carriage return. If the dialog area was not visible 
before you entered the command, it becomes visi- 
ble. If the dialog area was already visible, nothing 
happens. 


The following command initializes the terminal for Graphics 
Input (GIN) mode, setting it to use the thumbwheels as the 
input device for ten points: 


EcIE 0 10°R 


Press the SET UP key to exit from Setup mode. You can use 
the thumbwheels to locate the crosshair cursor and press 
ten alphabetic keys to exit from GIN mode. Or, you can put 
the terminal back into Setup mode and enter the following 
escape sequence command: 


EcID 0°R 


C-2 


ESCAPE SEQUENCES 
INLOCAL MODE 


When the terminal is in Local mode, you can execute both 
4010 and 4110 Series escape codes. In both cases, escape 
sequences have the following characteristics. Notice that 
the first two characteristics are the same as Setup mode, 
but the rest are different: 


@ The first character in the command is the escape charac- 
ter (ASCII 27). 


@ All alphabetic characters must be upper case. 


@ No carriage return is necessary; the command is exe- 
cuted as soon as you enter the last character. 


@ Characters are not echoed on the screen as you type 
them. | 


@ Parameters of acommand are not delimited by a space 
(although a space is a valid character in some com- 
mands). 


@ Keywords and numeric values greater than nine are 
entered in an encoded form (see the 47/0 Series Com- 
mand Reference Manual). 


The escape sequence to make the dialog area visible can 
be entered in Local mode as follows: 


1. Putthe terminal into Local mode. If the light in the 
LOCAL key is on, the terminal is in Local mode. If it is 
not on, press the LOCAL key and the light turns on as 
the terminal enters Local mode. 


2. The terminal should not be in Setup mode. The light in 
the SET UP key should be off; if it is on, press the key 
and the light will go off as the terminal leaves Setup 

~ mode. | 


3. The light in the Caps Lock key should be on, indicating 
that the key is active and all alphabetic characters will 
be in upper case. 


4. Press the following keys; the characters will not be 
echoed on the screen. 


EcLv1 
The command is executed when you enter the last charac- 
ter in the command. If the dialog area was not visible before 


you entered the command, it becomes visible. If the dialog 
area was already visible, nothing happens. 
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The following command initializes the terminal for Graphics 
Input (GIN) mode, setting it to use the thumbwheels as the 
input device for ten points: 


EcIEO: 


(The colon at the end of the command is the coded form of 
the integer 10 in Local mode escape sequence commands.) 


Press the LOCAL key to exit from Local mode. You can use 
the thumbwheels to locate the crosshair cursor and press 
ten alphabetic keys to exit from GIN mode. Or, you can put 
the terminal back into Local mode and enter the following 
escape sequence command: 


ESCAPE SEQUENCE COMMANDS 


ESCAPE SEQUENCE 
COMMAND SUMMARY 


The rest of this appendix lists the terminal’s 4110 Series 
escape sequences. They are listed alphabetically according 
to their one- or two-character op code. The setup command 
is shown if the escape sequence has one. 


Parameters for escape sequence commands are explained 
in the 41/0 Series Command Reference Manual and the 4110 
Series Host Programmers Manual. 
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Table C-1 


ESCAPE SEQUENCE COMMAND SUMMARY 


Escape Sequence Command Setup Command 

Ec! char ENABLE-4953-TABLET-GIN None 
DISABLE-4953-TABLET-GIN None 

EcIA int SET-PICK-APERTURE GINPICKAPERTURE 

EcIC int int SET-GIN-CURSOR GINCURSOR 

EcID int DISABLE-GIN GINDISABLE 

EcIE int int ENABLE-GIN GINENABLE 

EcIF int int int SET-GIN-STROKE-FILTERING TBFILTER 

EcIG int int int SET-GIN-GRIDDING GINGRIDDING 

EcIH int SET-TABLET-HEADER-CHARACTERS TBHEADERCHARS 

Ecil int int SET-GIN-INKING GININKING 

FeIL int SET-REPORT-MAX-LINE-LENGTH None 

EcIM int SET-REPORT-EOM-FREQUENCY REOM 

EcIN int SET-TABLET-SIZE TBSIZE 

EcIP int REPORT-GIN-POINT None 

EclQ char char REPORT-TERMINAL-SETTINGS None 

EcIR int int SET-GIN-RUBBERBANDING GINRUBBERBANDING 

EcIS int char char SET-REPORT-SIG-CHARS RSIGCHARS 

EcIT int SET-TABLET-STATUS-STRAP TBSTATUS 

EcIV int int xy xy SET-GIN-AREA GINAREA 

EcIW xy xy SET-GIN-WINDOW GINWINDOW 

EcIX int xy SET-GIN-DISPLAY-START-POINT GINSTARTPOINT 

EcJB string ACTIVATE-LPOS LPOS 

EcJC string string string COPY COPY 

EcJD string string string DIRECTORY DIRECTORY 

EcJE STOP-SPOOLING STOP 

EcJF string FORMAT-VOLUME FORMAT 

EcJH int SET-DMA-BLOCK-SIZE None 

EcJJ string DISMOUNT DISMOUNT 

EcJK string DELETE-FILE DELETE 

EcJL string LOAD LOAD 

EcJP string int PROTECT-FILE PROTECT 
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ESCAPE SEQUENCE COMMANDS 


Escape Sequence 


EcJQ string 

EcJR string string string 
EcJS string string string 
EcJU int 

EcJV string int string string 


ECKA int 

EcKC 

EcKD int int-array 
EcKE int 

EcKF int 


EcKH int 
EcKI int 

ECKL int 
ECKM int 
ECKN int 


EcKP int 
EcKQ 

EcKR int 
EcKS int 
ECKT int 


EcKV 

EcKX int 
EcKY int 
EcKZ int int int 
EcLB int 


EcLC int 
EcLE 

ECLF xy 
EcLG xy 
EcLH xy 


EcLI int int int 
EcLJ int 
EcLK int 
EcLL int 
EcLM int 


EcLP xy int 
EcLS int 
EcLT string 
EcLV int 
ECLX xy 


EcLZ 

EcMA real 

EcMB int int 
EcMC int int int 
EcMD int int int int 
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Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


Command 


REPORT-DEVICE-STATUS 
RENAME-FILE 

SPOOL 
SET-USER-NUMBER 
SAVE 


ENABLE-DIALOG-AREA 
CANCEL 
DEFINE-MACRO 
SET-ECHO 

LFCR 


HARDCOPY 
IGNORE-DELETES 
LOCK-KEYBOARD 
SET-MARGINS 
RENEW-VIEW 


SET-PAGE-FULL-ACTION 
REPORT-ERRORS 

CRLF 
SET-SNOOPY-MODE 
SET-ERROR-THRESHOLD 


RESET 

EXPAND-MACRO 
SET-KEY-EXECUTE-CHARACTER 
SET-EDIT-CHARS 
SET-DIALOG-AREA-BUFFER-SIZE 


SET-DIALOG-AREA-CHARS 
END-PANEL 

MOVE 

DRAW 

DRAW-MARKER 


SET-DIALOG-AREA-INDEX 
SET-DIALOG-AREA-ALTERNATE-INDEX 
INCLUDE-COPY-OF-SEGMENT 
SET-DIALOG-AREA-LINES 
SET-DIALOG-AREA-WRITING-MODE 


BEGIN-PANEL-BOUNDARY 
SET-DIALOG-AREA-SURFACE 
GRAPHIC-TEXT 
SET-DIALOG-AREA-VISIBILITY 
SET-DIALOG-AREA-POSITION 


CLEAR-DIALOG-SCROLL 
SET-GRAPHTEXT-SLANT 
SET-BACKGROUND-INDICES 
SET-GRAPHTEXT-SIZE 
BEGIN-FILL-PATTERN 


Setup Command 


None 
RENAME 
SPOOL 
USERNUMBER 
SAVE 


DAENABLE 
None 
DEFINE 
ECHO 
LFCR 


None 
IGNOREDEL 
LOCKKEYBOARD 
None 

RENEW 


PAGEFULL 
None 

CRLF 
SNOOPY 
ERRORLEVEL 


None 

None 
KEYEXCHAR 
EDITCHARS 
DABUFFER 


DACHARS 
None 
None 
None 
None 


DAINDEX 
DA2INDEX 
None 
DALINES 
DAMODE 


None 
DASURFACE 
None 

DAVIS 
DAPOSITION 


None 
None 
None 
None 
None 
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Escape Sequence 


EcME 
ECMF int 
EcMG int 
EcMI int 
EcML int 


EcMM int 
EcMP int 
EcMQ int 
EcMR real 
EcMS int int int 


EcMT int 
EcMV int 
EcMW int 
ECNB int 
EcNC int int 


END int 
EcNE int-array 
EcNF int 
ECNK int 
EcNL int 


EcNM int 
EcNP int 
EcNQ int 
EcNR int int 
EoNS int-array 


EcNT int-array 
EcNU int 
EcOB int 
EcOC int int 
EcOD int 


EcOE int int 

EcOH int-array int-array 
EcOL int 

ECOM int int 

ECON int-array int-array 


EcOP int int int int 
EcOS int int 

EcOT int 

EcPA string string string 
ECPB string int int 


EcPC string string string 
EcPE string int-array 
EcPF string int int int 
EcPI string int int 

EcPL string string 


4115B OPERATORS 


Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


Command 


END-FILL-PATTERN 
SET-GRAPHTEXT-FONT 


SET-GRAPHICS-AREA-WRITING-MODE 


SET-PICK-ID 
SET-LINE-INDEX 


SET-MARKER-TYPE 
SELECT-FILL-PATTERN 
SET-GRAPHTEXT-PRECISION 
SET-GRAPHTEXT-ROTATION 
SET-PANEL-FILLING-MODE 


SET-TEXT-INDEX 
SET-LINE-STYLE 
SET-LINE-WIDTH 
SET-STOP-BITS 
SET-EOM-CHARS 


SET-TRANSMIT-DELAY 
SET-EOF-STRING 
SET-FLAGGING-MODE 
SET-BREAK-TIME 
SET-TRANSMIT-RATE-LIMIT 


PROMPT-MODE 
SET-PARITY 
SET-QUEUE-SIZE 
SET-BAUD-RATES 
SET-PROMPT-STRING 


SET-EOL-STRING 
SET-BYPASS-CANCEL-CHAR 
ARM-FOR-BLOCK-MODE 
SET-BLOCK-CONTINUE-CHARS 
SET-DUPLEX-MODE 


SET-BLOCK-END-CHARS 
SET-BLOCK-HEADERS 
SET-BLOCK-LINE-LENGTH 
SET-BLOCK-MASTER-CHARS 
SET-BLOCK-NON-XMT-CHARS 


SET-BLOCK-PACKING 
~ SET-BLOCK-LENGTH 
SET-BLOCK-TIMEOUT 
PORT-ASSIGN 
SET-PORT-STOP-BITS 


PORT-COPY 
SET-PORT-EOF-STRING 
SET-PORT-FLAGGING-MODE 
MAP-INDEX-TO-PEN 

PLOT 
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Setup Command 


None 
None 
GAMODE 
None 
None 


None 
None 
None 
None 
None 


None 

None 

None 
STOPBITS 
EOMCHARS 


XMTDELAY 
EOFSTRING 
FLAGGING 
BREAKTIME 
XMTLIMIT 


PROMPTMODE 
PARITY 


_ QUEUESIZE 


BAUDRATE - 
PROMPTSTRING 


EOLSTRING 
BYPASSCANCEL 
BLOCKMODE 
BCONTINUECHARS 
DUPLEX 


BENDCHARS 
BHEADERS 
BLINELENGTH 
BMASTERCHARS 
BNONXMTCHARS 


BPACKING 
BLENGTH 
BTIMEOUT 
PASSIGN 
PBITS 


PCOPY 
PEOF 
PFLAG 
PMAP 
PLOT 
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ESCAPE SEQUENCE COMMANDS 


Escape Sequence 


ECPM string int-array 
EcPP string int 

EcPQ string 

EcPR string int 

EcQB int 


EcQD int 
ECQN int 
EcqO int 
Ecaq 

EcRA int int int 


ECRB int 
EcRC int 
EcRD int-array 
ECRE int 
ECRF int 


EcRG int int-array 
ECRH xy 

EcRI int-array 
EcRu int 

ECRK int 


EcRL int-array 
EcRN int-array 
EcRP int char-array 
EcRQ int-array 
EcRR xy xy int 


EcRS xy xy 
EcRT int int int 
EcRU int int int 
ECRV xy xy 
ECRW xy xy 


EcRX int xy xy xy 

EcSA int int-array int-array 
EcSC 

EcSB 

EcSD int int 


ECSE int 

EcSG int int int 

ECSH int int 

EcSI int real real real xy 
EcSK int 


EcSL int-array int-array 
EcSM int int 

EcSN 

EcSO int 

EcSP xy 
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Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


Command 


SET-PORT-EOL-STRING 
SET-PORT-PARITY 
REPORT-PORT-STATUS 
SET-PORT-BAUD-RATE 
SET-COLOR-COPIER-DATA-RESOLUTION 


SELECT-HARDCOPY-INTERFACE 
SET-NUMBER-OF-COPIES 
SET-IMAGE-ORIENTATION 
REPORT-COLORHARDCOPY-STATUS 
SET-VIEW-ATTRIBUTES 


SET-BACKGROUND-GRAY-LEVEL 
SELECT-VIEW 
SET-SURFACE-DEFINITIONS 
SET-BORDER-VISIBILITY 
SET-FIXUP-LEVEL 


SET-SURFACE-GRAY-LEVELS 
SET-PIXEL-BEAM-POSITION 
SET-SURFACE-VISIBILITY 
LOCK-VIEWING-KEYS 
DELETE-VIEW 


RUNLENGTH-WRITE 
SET-SURFACE-PRIORITIES 
RASTER-WRITE 
SET-VIEW-DISPLAY-CLUSTER 
RECTANGLE-FILL 


SET-PIXEL-VIEWPORT 
SET-PIXEL-WRITING-FACTORS 
BEGIN-PIXEL-OPERATIONS 
SET-VIEWPORT 

SET-WINDOW 


PIXEL-COPY 
SET-SEGMENT-CLASS 
END-SEGMENT 
BEGIN-LOWER-SEGMENT 
SET-SEGMENT-DETECTABILITY 


BEGIN-NEW-SEGMENT 
SET-GRAPHTEXT-FONT-GRID 
SET-SEGMENT-HIGHLIGHTING 
SET-SEGMENT-IMAGE-TRANSFORM 
DELETE-SEGMENT 


SET-CURRENT-MATCHING-CLASS 
SET-SEGMENT-WRITING-MODE 
BEGIN-HIGHER-SEGMENT 


-BEGIN-SEGMENT 


SET-PIVOT-POINT 


Setup Command 


PEOL 
PPARITY 
STATUS 3PPI 
PBAUD 
HCDATARES 


HCINTERFACE 
HCCOPIES 
HCORIENT 
None 

None 


None 
None 
None 
None 
FIXUP 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 
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Escape Sequence 


EcSQ int char-array 
ECSR int int 

EcSS int int 

ECST int int 

EcSU 


EcSV int int 

EcSx int xy 

EcSZ int int 

EcTB int int int 
EcTG int int-array 


ECTM int int 
Eco! int 
ECUB int 
ECUR xy-array 
ECUW xy xy 


EcUX int int 
EcSp 
EcUs 
Eon 
EpGg 


EcFs 
EcFr 
EcEa 
ECS, 

EcSo 


Ec char 
EoE, 
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Table C-1 (cont) 


ESCAPE SEQUENCE COMMAND SUMMARY 


Command 


REPORT-SEGMENT-STATUS 
RENAME-SEGMENT 
SET-SEGMENT-DISPLAY-PRIORITY 
BEGIN-GRAPHTEXT-CHARACTER 
END-GRAPHTEXT-CHARACTER 


SET-SEGMENT-VISIBILITY 
SET-SEGMENT-POSITION 
DELETE-GRAPHTEXT-CHARACTER 
SET-BACKGROUND-COLOR 
SET-SURFACE-COLOR-MAP 


SET-COLOR-MODE 
SELECT-CODE 
SET-DRAW-BOUNDARY-MODE 
DRAW-RECTANGLE 
SET-OVERVIEW-WINDOW 


SET-COORDINATE-MODE 
ENABLE-4010-GIN 
ENTER-ALPHA-MODE 
ENTER-BYPASS-MODE 
ENTER-VECTOR-MODE 


ENTER-MARKER-MODE 
PAGE 
REPORT-4010-STATUS 
SET-ALPHATEXT-FONT 
SET-ALPHATEXT-FONT 


SET-4014-LINE-STYLE 
4010-HARD-COPY 


ESCAPE SEQUENCE COMMANDS 


None 
None 
None 
None 
None 


None 
None 
None 
None 
CMAP 


CMODE 
CODE 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 
None 
None 
None 


None 
None 


Setup Command 
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Appendix D 


ASCII CHARTS 


This appendix includes a standard ASCII code chart and The code charts are: 
additional ASCII code charts which define the specific char- 


acters used as parameters (indicated by unshaded areas). Table Description 


D-1 ASCII Code Chart 


D-2 Characters Used in Char Parameters 

D-3 Characters Used in Int Parameters 

D-4 Characters Used in Int-Report Parameters 

D-5 Characters Used in Xy Parameters 

D-6 Characters Used in Xy-Report Parameters 
Table D-1 


ASCII (ISO-7-US) CODE CHART 


0 0 0 0 1 1 1 1 





CONTROL UPPERCASE LOWERCASE 





\ 
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ASClil CHARTS 





elelele| Nut 


—- 


Cao Ss 


Pes 


| | 


Table D-2 


CHARACTERS USED IN CHAR PARAMETERS 


CONTROL Torin UPPERCASE 


16 





Y) 
i 


mi mil wm 
= >< ~< 
Ce) Co N oO) Nn 4 Ce) No — 
NO No NO ~~ ~ en 


23 
D 
25 
Le | 3B, 
is as 


— 
Ro 


ed, 
Go 


NO 
10 @) 


— 
fv 
G 
=) 


tS 


1S) 
~~ 
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ASCII CHARTS 


Table D-3 


CHARACTERS USED IN INT PARAMETERS 


Hil Characters 


) 0, ) Q 1 1 1 1 
tg 8 ig | ty Ge | | | a 


CONTROL UPPERCASE LOWERCASE 









BITS 
B4 B3 B2 Bl 


Plefele| Mu | al So} Oe 
we) Sa i hg A 
pete el Ml al 2 
3 
A 












E D # 
a etl a 
1i0]o] E D 
a 
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Lol Characters 


0 0, ) 0 1 1 1 1 
‘yee ee 


CONTROL —ricures | UPPERCASE LOWERCASE 






BITS 
B4 B3 B2 Bl 
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ASCII CHARTS 


Table D-4 


CHARACTERS USED IN INT-REPORT PARAMETERS 


Hil-Report Characters Lol-Report Characters 


0 0 0 1 1 1 


; p 


6 112 






; 
iz 






2 
Q 









BITS 
B4 B3 B2 Bl 





UPPERCASE LOWERCASE 





\ 


| S| 
| S| 
Su 
za 
i) 
is 
iP 


96 17 


d q 


97 










Tels) 
ps] s | 
a Re 
Ie 
dp) op) = 
ne) _~ ° 
OO! © 
NO — 
oo N 
om 
oO 





Ke) 


102 11 


ice) 





0Q 
~* 
Le) 
1e8) 

= 
ke 
~~. 
© 


—_— 
>< 


2) 


104 12 
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ASCll CHARTS 


Table D-5 


CHARACTERS USED IN XY PARAMETERS 


HiY, HiX Characters 


0 @ Q @ 1 1 a] 1 
[sown | nis | arnt | soem 
80 96 112 








BITS 
B4 83 B2 Bl 


100 116 LoY, Extra Characters 





























LoX Characters 
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Table D-6 


CHARACTERS USED IN XY-REPORT PARAMETERS 


BITS 
B4 B3 B2 Bl 


UPPERCASE 


@)P 


109 


n ow 
94 110 126 


Ah 
79} 95 ay, 
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Appendix E 


OPTIONAL KEYBOARDS 


The following optional keyboards are available for the termi- OPTION 4A: UNITED KINGDOM 


nal. For information on how to install these optional key- KEYBOARD 
boards, see the 4//5B Service Manual. The viewing keys 
and thumbwheels are not shown in the keyboard illustra- 


fons This option permits the terminal to change to a United King- 


dom keyboard layout so that the United Kingdom characters 
are displayed. The only change is that the “#” sign is 
replaced by the English “£” sign. When this key is pressed 
(or the appropriate code received by the terminal), the “£” 
sign is displayed on the screen. The revised keyboard con- 
figuration is shown in Figure E-1 and the revised ASCII code 
chart is shown in Table E-1. 


CANCEL 


ae CLL 9 
LOCK FULL  XMT 
CS CS oa CS 


DIALOG SETUP LOCAL 
AREA COPY 


o 
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Figure E-1. United Kingdom Keyboard. 
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OPTIONAL KEYBOARDS 


E-2 


Table E-1 
UNITED KINGDOM CHARACTER SET 


Q 0 0 0 1 1 4 1 


BITS 
HIGH X&Y 
B4 B3 B2 Bl CONTRCE GRAPHIC INPUT LOW X LOW Y 


B oo 


she Sea 


66 98 






















aS al 
‘ie St -= ale 


S R 
i ee ren a 
27 


TS pf 7 Ol = el 


4665-48 





4115B OPERATORS 


OPTION 4C: SWEDISH KEYBOARD 


This option changes the standard keyboard configuration to 
a Swedish layout and allows Swedish characters to be dis- 
played. There are 17 changes to the keyboard, with three of 
these changes being new alphabet characters. When these 
seventeen keys are pressed (or the appropriate codes are 
received by the terminal), the corresponding characters are 
displayed on the screen. The revised keyboard configura- 
tion is shown in Figure E-2 and the revised ASCII code chart 
is shown in Table E-2. 





OPTIONAL KEYBOARDS 


OPTION 4F: DANISH/NORWEGIAN 
KEYBOARD 


This option changes the standard keyboard to a Danish/ 
Norwegian layout so that the Danish/Norwegian characters 
are displayed. There are 17 changes to the keyboard, with 
three of the changes being new alphabetic characters. 
When these 17 keys are pressed (or the appropriate codes 
are received by the terminal), the corresponding characters 
are displayed on the screen. The revised keyboard configu- 
ration is shown in Figure E-3 and the revised ASCII code 
chart is shown in Table E-3. 


KYBD PAGE 
LOCK FULL XMT 


oa 


DIALOG SETUP LOCAL HARD 
AREA COPY 


SHIFT BREAK 
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Figure E-2. Swedish Keyboard. 
































KYBD PAGE 
LOCK FULL XMT RCV 


oOo OF oo co 


DIALOG SETUP LOCAL HARD 
AREA COPY 
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Figure E-3. Danish/Norwegian Keyboard. 
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Table E-2 
- SWEDISH CHARACTER SET 


i 0 0, | o, ; 
LREARPETE EP 
16 9 
tad dal Med Gal 2 or 
9 1 
i128 ® 
D3 sal tal Sol Col See 
3 19 9 
FY 
4 20 
a Fal Ea Te 
ad Bal Bag al Vad 
1 118 
W W 
al ol lal Sol Mol Bal 


Cy 8 H X h X 


24 40 96 72 88 104 12 


empl eal Ty tT alia 
121 

7 
HEHE PEEP ER EARP ES 


eee feel pec 
sae Ma 

PPh teal 
al Salad Dal al Mad ol 
PERT. : 
RUBOUT 

PERS sal “al tal Col al 2a 
= os 127 
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1, 


: 
ine 
5 





~ 


oi 


— 


a 

ome 

— 
\e) NO 


Rim 


oe 
ae 
Ee 


17 


_ 


mom Cw 
ase CD 
Re eA 
eS 
+r} ” 
a le 


1 
1 


= 
A 
oo) 
Pe 
LS 
ac 
cC 
= 


io 


6 
7 
8 
9 
00 
01 
02 


© 
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Table E-3 
DANISH/NORWEGIAN CHARACTER SET 






BITS 
B4 B3 B2 Bl 





42 


fol Cn ta tal §, 
DO a 
| lolo] Fr S oa]? 44 
CC 
RETURN7T3 29 45 61 7 109}. 25 
te 
14 30 46 62 78 94 110 126 
RUBOUT 
| 15 es 47 63 79 95 111 127 










Oo) 
© 
N 









4665-50 


4115B OPERATORS 


E-5 


OPTIONAL KEYBOARDS 


OPTION 4K: KATAKANA KEYBOARD 


This option enables selection of either English or Katakana 
characters for entry and display. The key in the lower left 
hand corner (Caps Lock, on the standard keyboard) con- 
trols character set selection. Pressing this key toggles the 
character set. The keycap light indicates the active charac- 
ter set: on indicates Katakana character set and off indi- 
cates English character set. The Caps Lock function is 
moved to the unshifted SETUP key and only has an effect 
with the English character set. Shift-SETUP is required to 
select setup mode. Setup mode only has meaning with the 




















English character set; therefore, setup mode selection 
causes the English character set selection. Pressing the 
Break key also causes English character set selection. The 
SETUP key light indicates both caps lock and setup mode in 
the following manner: 


off 


on (steady) 
on (fast blink) 
on (slow blink) 


no setup mode and no caps lock 
no setup mode and caps lock 
setup mode and no caps lock 
setup mode and caps lock 


The revised keyboard configuration is shown in Figure E-4 
and the revised ASCII code chart is shown in Table E-4. 

















SETUP 
CLEAR (BLINK) CANCEL 


DIALOG CAPS LOCAL 
AREA LOCK 
(STEADY) 


KYBD PAGE 
LOCK FULL 


XMT = RCV 
oo co 
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Figure E-4. Katakana Keyboard. 
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Table E-4 
KATAKANA CHARACTER SET 

















SHIFT IN SHIFT OUT 


Oo Pad de cd 


BITS 
CONTROL ALPHANUMERIC CONTROL KATAKANA 


B4 B3 B2 Bl 


er a a a ee 
al id te Sl ek a 
Pelee] STK Oe ad Fal Bad Rel Pad Sg KOZ) Tad Fol Yl Aad | 
cll wt EP EP EOE EA LOE EAE. he 

lie EP RPE Pee ee Ee 
PPpfena [wa 8 TS TEL Ue] w fe fua = Talal 
Be de nt ca 
Wii Ba ol Tad Cod Mad Bal Medel Tel 7 Fad Za Fad | 
ee a Fe i ee lee ta a 
rosie ae SSL Lee bare oe eet 
re ae ak ee el es a ee, 
PO et ak Sk oe Noh al gk ghd ke nd 
a de 
ee od, a i 
et ee og Ne Re ee el 
PT SS at Pad Onl ad del SL ad Mal Po od | 


4703-02 


4115B OPERATORS E-7 


‘Appendix F 


EXAMPLES OF OPERATION 


The following seven examples will help you become familiar 
with some of the features of your terminal. You don’t need to 
go through all of the examples in one sitting or do all of them 
in the order in which they are shown. However, whenever 
you work through any of them, you should do Example 1 
first, since it sets up the terminal so that the examples will 
work as shown. You will also need to do Example 4 (in which 
segments are created) before Examples 5 or 6 (in which the 
segments are manipulated). 


These examples provide a few simple and quick exercises 
to familiarize you with the terminal. Therefore, most com- 
mands are used with very little explanation. References are 
made to the manuals where complete explanations can be 
found. These examples are also found in the brochure 
Introducing Your 4115B Computer Display Terminal.The 
command words for all setup commands are completely 
spelled out in the examples. They can, however, be abbrevi- 
ated to as few characters as necessary to distinguish them 
from other commands (usually two or three characters). 


Setup commands are shown in uppercase characters so 
they can be easily distinguished from the rest of the text. 
However, setup commands can be entered in uppercase or 
lowercase. You can use the Caps Lock key (press it so the 
light in it is on) to cause all alphabetic characters to be 
uppercase. 


Escape sequence commands used in Setup mode (as in 
Examples 4-7) must be entered in uppercase, as shown. 


In several examples, you are told to toggle the DIALOG key. 
That means to press the DIALOG key once to turn the dialog 
area off, and then press it again to turn the dialog area back 
on. 
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EXAMPLE 1 — GETTING READY 


Do this example before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


1. If the power is already on, skip to Step 2. 


If the power is not already on, press the POWER switch 
(Figure F-1). A green indicator is visible in the switch 
when you release it; the lights in the keyboard blink on 
and off as the terminal goes through the power-up pro- 
cedure, during which it tests certain parts of itself to be 
sure it is ready for operation. In about 15 seconds, the 
screen is erased and the cursor appears. If an error 
message Is displayed or the cursor does not appear, 
See Appendix B. 


Go to Step 3. 


POWER 
SWITCH 








Figure F-1. The POWER Switch. 
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: SELF MASTER 
| TEST RESET 
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Figure F-2. The MASTER RESET and SELF TEST Buttons. 


So that the examples in this brochure will execute as 
shown, reset the terminal to its factory default operat- 
ing environment. To reset it, do the following: 


2. Dothis if the power is already on. Press the MASTER 3. 
RESET button (Figure F-2). The terminal goes through 
the power-up self-test procedure. Within about 15 sec- 
onds the screen erases and the cursor appears on the 


screen. 
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a. Press and hold the SELF TEST button. 


Continue to hold SELF TEST while you press and 411X Menu 
release the MASTER RESET button. ae 
f1 4115 Display 
Release the SELF TEST button. f2 Processor Board 
d. The indicator lights in the keyboard flash and ina ie ete 
few seconds the terminal bell rings. Within 20 sec- ie 
onds after the bell rings, enter Ctrl-C: That is, press Selection 
and hold down the Ctrl key while you press and Function Key-Test Selection 
release the C key, then release the Ctrl key. Within “C-411X Menu 
about 15 seconds, a menu appears on the screen “D-Current Menu 
(Figure F-3A). Bees 
e. Press the key labeled F2. Another menu (Figure F- A 
3B) appears. CMOS is an acronym for the kind of 
memory used to store the terminal’s operating 
environment. Processor Board Menu 
f. Press the key labeled F1. The message shown in ie 
Figure F-3C is displayed below the menu. CMOS e SPs 
Reset means that the operating environment has f3 Host Port 
been reset to its factory default condition. a 
g. Nowenter Ctrl-E. In a few seconds, the screen is ee y-Test Selection 
erased and the cursor appears again. “411% Menu 
“D-Current Menu 
“E-End 
# 
B 


Processor Board Menu 
f1 CMOS-Reset 
f2 Keyboard 
£3 Host Port 
Selection 
Function Key-Test Selection 
*“C-411X Menu 
“D-Current Menu 
“E-End 
¥f 4 
CMOS~Reset 
selection 
Function Key-Test Selection 
“C-411X Menu 
“D-Current Menu 
“E-End 
% 
C 
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Figure F-3. Self Test Menus. 
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F-4 


Press the DIALOG key (Figure F-4). The light in the key 
comes on and the dialog area becomes visible. Even 
though it is visible, you can’t see anything in it since it 
has not yet been enabled. 


Press the SET UP key (Figure F-4). The light in the key 
comes on and an asterisk appears at the left margin, 
next to the cursor. 


Enter the following setup command to enable the dia- 
log area (the °n means press the Rtn key, Figure F-4). 


DAENABLE YES ©r 


Now that it is both visible and enabled, the cursor and 
asterisk appear in the dialog area. 


The brightness of the display is controlled by the 
INTENSITY control (Figure F-5). Turn the knob to the 
right to make the display brighter, to the left to make it 
dimmer. Set the brightness to a desirable level. 

Press the Page key (Figure F-4). This erases the part of 
the screen that is not displaying the dialog area. The 
dialog area is not erased. 


Press the CLEAR key (Figure F-4) by pressing Shift and 
DIALOG at the same time. This erases the dialog area 
but has no effect on the non-dialog portion of the 
screen. 


Now the cursor is blinking on the first line of the dialog 
area, but nothing else is on the screen. 


DIALOG/CLEAR 


Page 


INTENSITY 
CONTROL 





SEGAUSS 


Figure F-5. INTENSITY Control. 


SET UP 





Rtn 


Figure F-4. Page, DIALOG/CLEAR, SET UP, and Rtn keys. 
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EXAMPLE 2 — MANIPULATING THE 
DIALOG AREA 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


This example introduces some of the commands used to 
manipulate the dialog area. It also includes other general 
setup commands, how to adjust the brightness level, and 
how to use the thumbwheels to view the contents of the dia- 
log area. 


1. The STATUS setup command reports all or part of the 
current terminal operating environment. This example 
illustrates various forms of the STATUS command. 
Enter the following STATUS command for a report (Fig- 
ure F-6) of which keys are assigned for editing. 


STATUS EDITCHARS r 
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The report lists three characters, the first of which rep- 
resents the terminal’s character-delete character. The 
box means that the current character-delete key is Rub 
Out. If you make a mistake when typing a setup com- 
mand, press the Rub Out key to back up along the cur- 
rent line. Characters are deleted as the cursor 
backspaces. 


The second character is the /ine-delete key. The °n 
means the ASCII cancel character is currently the line- 
delete character (this is not the same as the CANCEL 
command key). If you want to delete an entire line, type 
the cancel character by entering Ctrl-X. The cursor 
moves back to the beginning of the line, erasing the 
entire line as it does so. 


The third character in Figure F-6 is called the /iteral 
character. \t is discussed in Example 3. 


Figure F-6. STATUS EDITCHARS Report. 
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2. Enter the following command for a status report on all The dialog area is set to display five lines at a time; 
communications parameters (the result of the com- since the status report is more than five lines long, you 
mand is shown in Figure F-7). cannot see all of it. 


STATUS COMMUNICATIONS £r 





Figure F-7. Result of STATUS COMMUNICATIONS Command. 
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Rotate the right thumbwheel (Figure F-8) down to scroll 
through the dialog area so you can examine the rest of 
the contents of the dialog buffer. 


Enter the following command to increase the visible 
portion of the dialog buffer: 


DALINES 20 ©r 


Toggle the DIALOG key; now 20 lines of the dialog 
buffer are visible (Figure F-9). 








Figure F-8. The Thumbwheels. 


STATUS COMMUNICATIONS 
COMMUNICATIONS 


Figure F-9. Adjusted Dialog Display of STATUS COMMUNICATIONS Report. 
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EXAMPLES OF OPERATION 


4. The following commands affect the dialog area by 5. Tochange the dialog area back to its previous orienta- 
reducing the length of lines and relocating it. Toggle the tion, enter the following commands and then toggle the 
DIALOG key after entering these commands to update DIALOG key: 
the dialog area. DALINES 5 Cr 

DACHARS 25 ©r DAPOSITION 0 0 °r 

DAPOSITION 1000 1000 °r DACHARS 80 ©r 
The factory default dialog area is located such that its 
lower-left corner is at the lower-left corner of the screen 6. Press the Page and CLEAR keys to erase the entire 
(0,0). It is now relocated (Figure F-10) so that the dialog screen. 


area’s lower-left corner is at point (1000,1000). 


*DALINES c@ 

*DACHARS 25 
*DAPOSITION 1644 1644 
¥ 
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Figure F-10. Relocated Dialog Area. 


F-8 4115B OPERATORS 


EXAMPLE 3 — PROGRAMMING 
KEYS 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


Most keys can have one or two macros (character strings 
and/or commands) programmed into them. When a macro 
is programmed into a key, the key is expanded to generate 
that macro when you press it. 


Va 


Enter the following command to increase the visible 
extent of the dialog area and then toggle the DIALOG 
key to update the dialog area: 


DALINES 20 ©r 


Enter the following command to program the key 
labeled F1 to mean “STATUS EDITCHARS”: 


DEFINE F1 ‘STATUS EDITCHARS’ Cr 


In this command, be sure to type in the characters “F”, 
“1”. This DEFINE command creates a macro and asso- 
ciates it with key F1. There are many variations of the 
DEFINE command. See Section 6 for details. 


Press the key labeled F1. The alphabetic string “STA- 
TUS EDITCHARS” appears on the screen. 


Now press the Rtn key and the terminal executes the 
STATUS EDITCHARS command. 


Notice the third character in the edit character report 
(Figure F-11). This is called the /iteral character. 


The literal character is used when you want to include 
in a macro acharacter that would normally be exe- 
cuted, such as a carriage return. For example, a key 
can be programmed to not only display a character 
string, but to execute that command because a Car- 
riage return is included in the macro. 


To program the key labeled F2 to display and execute 
the STATUS EDITCHARS command, enter the follow- 
ing: 

DEFINE F2 ‘STATUS EDITCHARS ~ ©r’ ©r 


When you type the literal character, it is displayed; 
when you press the Rtn key, the cursor backspaces and 
types ©r over the literal character. Type a single closing 
quote to end the macro and then press Rtn again to ter- 
minate the command. 


4115B OPERATORS 


EXAMPLES OF OPERATION 


Now press the key labeled F2; the terminal executes 
the STATUS command. Figure F-11 shows the result of 
that command as well as the entire sequence of com- 
mands in this example. 


To delete all macros currently programmed into the 
keys, enter the DEFINE command in the following form: 


DEFINE ALL ©r 


Macros are also deleted when the terminal is turned off 
or reset. 


Reduce the visible extent of the dialog area to five lines 
by entering the following command and then toggling 
the DIALOG key: 


DALINES 5 £r 


Press the Page key and then the CLEAR key to erase 
the screen. 


DALINES 20 . 
*DEFINE F1 'STATUS EDITCHARS' 
-¥STATUS EDITCHARS © | 


EDITCHARS..... ...e. go - 
*STATUS EDITCHARS 
EDITCHARS....... .-% % - 
%& 

A 

DALINES 20 


*DEFINE F1 'STATUS EDITCHARS' 
*STATUS EDITCHARS _ 
EDITCHARS.........-© % 
B 
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Figure F-11. Results of Programming a Key. 
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EXAMPLE 4 — 
ENTERING GRAPHICS AND ESCAPE 
SEQUENCE COMMANDS 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


This example introduces four concepts: 

@ Use of escape sequence commands in Setup mode 
@ Local graphics 

@ Color graphics 


@ Panels 


Graphics are typically generated by a host-resident pro- 
gram, and escape sequence commands will not generally 
be used locally. However, there may be times when you 
want to create graphics locally, as illustrated in this exam- 
ple. This is also an easy way to create the segments used in 
Examples 5 and 6. 


1. Enter the following series of escape sequence com- 
mands exactly as shown. Press the key labeled Esc to 
enter the c character. The next two characters are the 
command op-code; these must be entered in upper- 
case; there is no space between the first three charac- 
ters. Then enter a space and the numeric parameters 
with a space between each parameter (except the last 
command, which has no parameter). Terminate each 
command with a carriage return. 


There is no visible result for the first three commands. 
The series of commands draws the frame of a house 

(defined as a panel) and fills it with a blue color. Figure 
F-12A is a black and white representation of the result. 


EcomS000CR — 7-29 


EcMP —4 Cr V1 
FcSO1°R 

EcUR 1000 750 2500 1500 Cr 
EcSC Cr 


A panel is simply an enclosed area. The first command 
in the preceding sequence specifies how the terminal 
will fill in panels. The second command specifies that 
the panel should be filled with blue. The third command 
opens a segment named 1. That means that all subse- 
quent commands become part of Segment 1, continu- 
ing until Segment 1 is closed. The fourth command 
draws a rectangle with lower left corner at (1000, 750) 
and upper right corner at (2500,1500). The last com- 
mand closes Segment 1 and then the panel is filled. 


F-10 


After you have entered these commands, pressthe _ 
Page key. Pressing Page permanently erases vectors 
that are not part of asegment. Vectors included ina 
segment are erased briefly and then redrawn. 


If you make a mistake entering the coordinates, the ter- 
minal draws to the wrong point. If that happens, you 
should close the segment, delete the segment, open 
another segment with the same name, and start over. 


For example, if you made a mistake in drawing Seg- 
ment 1, delete it and start over by entering the following 
commands: 


EcSC Cr 
EcSK 1°rR 


The first command closes the open segment and the 
second command deletes it from the terminal’s mem- 
ory. Then go back to Step 1 and enter the correct com- 
mands. 


The following series of commands draws the roof out- 
line and then fills in the roof with a cyan color (Figure 
F-12B). Note the action of each LG command. 


EcMP —5 Cr 

EcSO 2°r 

EcLP 900 1435 1 °r 
EcLG 1750 2000 Sr 
EcLG 2600 1435 Cr 
EcLE Cr 

EcSC Cr 


FUR 2™ §n> Al Zn> 
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4. This next series of commands draws the left window of 
the house (Figure F-12C). The first command specifies 
the panel filling color to be green. The second com- 
mand opens Segment 3; the third draws the rectangle; 
the fourth closes the segment. 


EcMP —3 Cr 

EcSO 3°r 

ECUR 1100 950 1300 1200 ©r 
EcSC Cr 


The door, filled with red (Figure F-12D): 


EcMP —2 Cr 

Ecso 4°r 

ECUR 1425 750 1675 1200 ©r 
EcSC Sr 


And finally the right window, filled with white 
(Figure F-12E): 


EcMP —1 ©r 

EcSO5°r 

ECUR 1800 950 2400 1200°R 
EcSC Sr 


5. Press the Page and CLEAR keys. This erases vectors 
from the screen that are not saved in segments and 
erases the dialog area. 





Figure F-12. Graphic Displays Created by Escape Sequence Commands. 
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EXAMPLE 5 — MANIPULATING A 
SEGMENT AND USING VIEWING 
KEYS 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. The 
segments used in Example 5 are created in Example 4. 


There are many ways to manipulate segments. Steps 1 and 
2 illustrate ways segments would normally be manipulated 
by a host program. See the 4//0 Series Command Reference 
Manual and 4110 Series Host Programmers Manual for 
details. 


Steps 3-9 illustrate how to use the ZOOM, PAN, VIEW, and 
RESTORE keys. All of the viewing keys are explained in 
Section 2 of this manual. 


1. Make the right window of the house invisible by enter- 
ing the following command: 


EcSV50°R 


Press the Page key. The segment containing the frame 
of the house is not deleted from memory, but it is no 
longer visible on the screen (Figure F-13). 


Make it visible again by entering the following com- 
mand and then pressing the Page key. 


EcSV51°R 


2. You can highlight the house’s door with the following 
command. The terminal highlights the door by blinking 
it off and on. 


EcSH41°R 


Turn the highlighting feature off by entering the follow- 
ing command: 


EcSH40°r 


3. Press the SET UP key to exit from Setup mode. Press 
the DIALOG key to make the dialog area invisible. 


4. Press the ZOOM key (Figure F-14) to make the zoom 
function of the viewing keys active. A framing box 
appears at the edge of the screen, with the lower-left 
and upper-right corners of a rectangle in the center of 
the box (Figure F-15). 








Figure F-13. Display with Invisible Segment. 
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Figure F-14. The Viewing Keys. 
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Figure F-15. Display with Framing Box for ZOOM. 
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Rotate the top thumbwheel down or the bottom 
thumbwheel to the left to decrease the size of the fram- 
ing box, as shown in Figure F-16. 





Figure F-16. Adjusted Framing Box for ZOOM. 
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5. Press the PAN key to make the pan function of the view- When you rotate the top thumbwheel up or down, the 
ing keys active. The framing box remains on the screen framing box moves up or down. When you rotate the 
in the same position, but it now has across in its center bottom thumbwheel to the left or right, the framing box 
(Figure F-17). moves to the left or right. 
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Figure F-17. Framing Box with Crosshair for PAN. 
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In Figure F-18, the framing box has been repositioned. 





Figure F-18. Repositioned Framing Box for PAN. 
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6. Use acombination of zooms and pans to position the then the pan function to position the box. You can use 
framing box as shown in Figure F-19. First use the either function alternately by pressing the appropriate 
zoom function to make the box the appropriate size, key. 
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Figure F-19. Framing Box After ZOOM and PAN. 
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When you have the box positioned, press the VIEW key 
(Figure F-14). The view is updated to display just the 
contents of the framing box (Figure F-20). 


Press the RESTORE key (Figure F-14) by pressing the 
Shift and VIEW keys at the same time. This restores the 
Original view. 


10. 


You can continue to experiment with the ZOOM and 
PAN functions. When you are finished, press the 
OVERVIEW key (Shift-PAN). Then press either the 
ZOOM or PAN key, depending on which one is lit. 


Press the DIALOG key to make the dialog area visible 
again. Press Page and then CLEAR to erase anything 
on the screen that is not saved in a segment. 
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Figure F-20. Display Updated with VIEW. 
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EXAMPLE 6 — USING THE DISK 
DRIVE AND 3PPI 


Do Example 1 before doing any of the others, since it sets 5 
up the terminal so examples will operate as described. The a DOOR BAR 
segments used in Example 6 are created in Example 4. oo , 


Example 6 illustrates the use of the optional disk drive and 
the three-port peripheral interface (SPP). 


NOTE 


Be sure that the disk you use for this example is one 
that does not contain information that you want to 
save. The first step in the example formats the disk, 
which effectively erases any information already 
stored on it. 


1. Press in on the door bar (Figure F-21) to open the disk 
drive. If the disk you are going to use has a write-pro- 
tect notch, be sure that it is covered. Insert a disk as 
shown in Figure F-22. Press down on the disk drive 
door until it snaps closed. Press the WRITE PROTECT 
switch so that the red light above the switch is off. 


2. Enter the following command: 
FORMAT FO: Cr 
It takes about a minute for the terminal to format the 
disk. During that time, the light in the disk door is on, 


indicating that the disk is operating. When the disk is 
formatted, the light turns off. 


3. Enter the following command to save all existing seg- 
ments into a file named HOUSE. 


SAVE SEG ALL TO F0O:HOUSE ©r 





Figure F-22. Inserting a Disk. 


4115B OPERATORS F-19 


EXAMPLES OF OPERATION 


4. Delete all segments from the terminal’s memory (but 8. The following commands delete individual parts of the 
not from the disk) with the following command: house. This command deletes the frame of the house: 
EcSK ALL ©r EcSK 1°r 
Press the Page key. Since the segments are no longer This command deletes the roof: 


stored in terminal memory, they are erased. Eosk 2Cr 


To restore the file containing the house segments, enter atac sanscacinn ais Taiaea GenWay: 
the following command: 
E Cc 
LOAD FO:HOUSE Cr cSK 3 *R 


The LOAD command reads the specified file and exe- This command deletes the door: 


cutes it as acommand file. The house is redrawn as EcSK 4°R 
five individual segments just as it was before. And this command deletes the right window: 
5. Save each segment into an individual file with the fol- EcSK 5°R 


lowing commands: 
9. Ifyou have the 3PPI and a 4662 or 4663 Plotter, you 


ee a : be ee can plot this display. First use an RS-232 cable to con- 
SAVE SEG3 TO F0:L WINDOW = nect the plotter to a 3PPI port. Then assign a device 
SAVE SEG 4 TO ate OoR CR i driver and set up the port for the plotter. For example, 
‘ the following commands assign the 4663 device driver 
2M eens Orne a to Peripheral Port 1 and set the port’s parameters so it 
Delete all segments again: can display a file from the disk drive: 
EcSK ALL Sr PASSIGN P1: 4663 r 
Press Page to erase the screen PBAUD 1 200 “r 
PBITS 18°R 


6. Enterthe DIRECTORY command for a listing of all files 
on the disk. Use the top thumbwheel to scroll the dialog 
area to observe the directory contents. 


DIRECTORY FO: ©r 


Set the switches on the back of the 4663 to 2, 2, 2, and 
3, respectively. Now copy the segments on the plotter 
through the 3PPI with the following command: 


COPY FO:HOUSE TO P1: ©r 
7, Tagsloreeacn part oring house naividually: 10. After the plot is complete, press the Page and CLEAR 
LOAD FO:FRAME °r keys to erase the screen. 

LOAD FO:ROOF °r 

LOAD FO:LWINDOW °r 

LOAD FO:DOOR Cr 

LOAD FO:RWINDOW Cr 
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EXAMPLE 7—USING GRAPHIC 
INPUT 


Do Example 1 before doing any of the others, since it sets 
up the terminal so examples will operate as described. 


1. Enter the following command for Graphic Input mode 
using the crosshair cursor to locate one point: 


EclIEO 1°R 


Press the SET UP key to exit from Setup mode (the 
light in the key should go off). Move the crosshair cur- 
sor by rotating the thumbwheels. The top thumbwheel 
moves the horizontal line of the crosshair, the bottom 
thumbwheel moves the vertical line of the crosshair. 
The intersection of the horizontal and vertical lines is 
the point that is sent to the program. 


Press the Shift key at the same time you rotate a 
thumbwheel. Notice that the cursor moves much more 
slowly. This allows you to be very precise in locating a 
point on the screen. 


Press any alphanumeric key. The terminal transmits the 
point you located. GIN Mode is terminated because it 
was only initialized to locate one point. 
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Press the SET UP key again to put the terminal back 
into Setup mode, then enter the following commands: 


EcML 2 ©r 
EclIEO 5 &r 
EciHlO1°R 


The first command specifies the line color to be red. 
The second command puts the terminal into GIN Mode 
until you locate five points. The third command initial- 
izes a function called inking. With inking in use, the ter- 
minal draws a line from the last point located to the next 
point you specify. 


Exit from Setup mode by pressing the SET UP key. 
Move the crosshair around the screen and locate (spec- 
ify) a point by pressing an alphanumeric key. Nothing is 
visible when you locate the first point. As you locate the 
next four points, the terminal draws lines between 
them. The crosshair disappears after you locate the 
fifth point. 


To terminate the inking feature, put the terminal back 
into Setup mode and enter the following command: 


Ecii0 0 °rR 
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COLOR STANDARD 


In the HLS color coordinate system, 120° 60° 
the color space is represented as a 
double-ended cone. 





















The HUE coordinate runs 
counterclockwise around the 180° 
cone. (0 to 360 degrees.) 


The LIGHTNESS coordinate runs 
vertically up the cone. (0% to 100%.) 


The SATURATION coordinate runs 
radially outward from the axis of 

the cone. The SATURATION coordinate 
is a percentage of the maximum 

possible saturation at a particular 180° 
LIGHTNESS level. (0% to 100%.) 


300° 
60° Magenta 





HUE Yellow 180° 


340° 


300° Cyan 
60° 


150° 30° 


180° 


210° 330° 


NOTE: For clarity, this figure 
shows the cone divided into only 
64 colors, as in the TEKTRONIX 
4027 terminal. The 4115B termi- 
nal has a wider repertory of color 
mixtures. 


Figure G-1. The HLS Color Cone. 
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TEKTRONIX 
COLOR 
STANDARD 


Overview: 


The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that “color theory” is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ICS. 


In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 


Color Concepts: 


Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 


Hue: The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from O to 360. 


The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from 0 to 100% 
with black being O (bot- 
tom of cone) and white 
being 100% (top of cone). 


Lightness: 


The characteristic which 
describes the extent to 
which a color differs from 
a gray of the same light- | 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 0% (maxi- 
mum white content at that 
lightness level) to 100% 
(full saturated). 


Saturation: 


Geometrically, colors can be described In 
terms of a double cone. 

Variations in lightness are represented 
along the axis, with white at the apex of 

the cone and black at the opposite apex. 
Variations in saturation are represented by 
radial distances from the lightness axis, in 
constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 


Copyright © 1982 by Tektronix, Inc., Beaverton, Oregon. 
Printed in the United States of America. All rights reserved. 
Contents of this publication may not be reproduced in any form 
without permission of Tektronix, Inc. U.S.A. and foreign TEK- 
TRONIX products covered by U.S. and foreign patents and/or 
patents pending. 


TEKTRONIX is a registered trademark for Tektronix, Inc. 
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ORDERING INFORMATION 


This appendix contains ordering information for standard 
and optional terminal accessories that will normally be of 
use to an operator. There are other accessories that will be 
of use only for servicing and adjustment of the terminal. For 
those accessories, refer to the parts list in the 4115B Serv- 
ice Manual, Volume 2. 


STANDARD ACCESSORIES OPTIONAL ACCESSORIES 
4115B Introduction Brochure 070-4663-00 4115B Service Manual, Vol. 1 070-4666-00 
4115B Computer Display Terminal 4115B Service Manual, Vol. 2 070-4667-00 
Operators Manual 070-4665-00 640-0219-00/01 Display Module Service 
4110 Series Host Programmers Manual 070-4664-00 Manual 070-4668-00 
4110 Series Command Reference Manual 070-3892-00 ECC RAM Service Manual 070-4701-00 
4110 Series Reference Guide 070-4715-00 Function Key Overlays (Set of 6) 334-3290-02 
Power Cord 161-0123-00 
Host Port RS-232 Cable 012-091 1-00 
Function Key Overlays (Set of 6) 334-3290-02 
Display Cables 
BNC cable 012-0074-00 
control cable 012-0525-00 
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4115B terminal 
accessories 1-2 
compatible products 1-3 
display module 1-2, 1-4 
features 1-4 
general description 1-2 
options 1-3 
related manuals 1-1 
4953/4954 emulation 6-68 


accessories, terminal 1-2 
Additive color mode 6-20 
active tablet area 6-68 
ADE 6-7 
alphanumeric keys 2-10 
alternate color index 6-24 
ANSI mode 6-21 
ANSI mode errors A-29 
arm for Block mode 6-14 
array parameter type 6-7 
ASCII code charts 
standard D-1 
with character parameters D-2 to D-6 
for optional keyboards E-2 to E-7 
ASCII decimal equivalent (see ADE) 
ASCIl keys 2-10 
aspect ratio 2-21 
attaching the graphics tablet 3-23 
Automatic Request To Send (Half Duplex mode) 6-34 
Autorepeat feature 2-10 


Back Space key 2-11 

baud rate 5-2 

BAUDRATE 5-2, 6-11 
BCONTINUECHARS 5-5, 6-12 
BENDCHARS 5-5, 6-12 
BHEADERS 5-5, 6-13 

bias, how to restore 3-24 
BLENGTH 5-5, 6-13 
BLINELENGTH 5-5, 6-14 

block data packing 5-6, 6-16 
block header sequence 5-5, 6-13 
block length 5-5, 6-13 

_ block line length 5-5, 6-14 

block master characters 5-6, 6-15 
Block mode 5-5, 6-14 

Block mode non-transmittable characters 6-15 
block timeout 5-6, 6-17 
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block-continue characters 5-5, 6-12 
block-end characters 5-5, 6-12 
BLOCKMODE 5-5, 6-14 

blocks (data transmission) 5-5 
blocks (disk) 3-8 
BMASTERCHARS 5-6, 6-15 
BNONXMTCHARS 5-6, 6-15 
BORDER key 2-22 

BPACKING 5-6, 6-16 

Break key 2-13 

break time 5-3, 6-16 

BREAKTIME 5-3, 6-16 
BTIMEOUT 5-6, 6-17 

buttons (see controls) 

bypass cancel character 5-4, 6-17 
Bypass mode 6-17 
BYPASSCANCEL 5-4, 6-17 

byte macros 6-31 


CANCEL key 2-18 
Caps Lock key 2-15 
Carriage return 2-12 
implies line feed 6-23 
char parameters D-2 
character colors in dialog area 6-26 
character delete character 6-9, 6-35 
character parameter type (in setup commands) 6-7 
CLEAR key 2-17 
CMAP 6-18 
CMODE 6-19 
CMY color system 6-18 
CODE 6-21 
color copier 
spooling to 3-21 
use of 3-20 
color copy commands 3-20 
color modes 6-20 
color index 6-18 | 
assignment to plotter pen 6-56 
default color assignments 6-19 
definition of 6-18 
for dialog area 6-24, 6-26, 6-28 
for graphics surfaces 6-18 
how to blink 6-18 
color purity, problems with 2-6 
color-overlay-mode parameter 6-20 
color-specifying-mode parameter 6-20 
color-to-gray-level transform 6-20 


INDEX 


command files 6-49 
command keys 2-14 
command line, maximum length of 6-8 
command summaries 
3PPI (peripheral ports) 3-15 
color copy 3-20 
disk drive 3-8 
escape sequence C-3 to C7 
file transfer 3-3 
host communications 5-1 
setup 6-3 
tablet setup 3-23 
command terminator 6-8 
command word 6-7 
abbreviations of 6-7 
communications (host) overview 5-1 
standard features 5-2 
connectors 
KEYBOARD 2-6 
rear panel 2-22 
control characters 2-10 
in Snoopy mode 6-63 
control keys 2-10 
controls, front panel 2-1 
controls, rear panel 2-22 
CONVERGE button (DEGAUSS/CONVERGE) 2-6 
coordinate space 2-20 
COPY 6-21 
copying a file 
host-to-plotter copy 3-18 
to a printer 3-19 
to/from a disk 3-11 
to/from a host 3-12, 6-23 
vs spooling 3-13 
CRLF 6-23 
crosshair cursor 4-2 
Ctrl key 2-12 
cursor 
crosshair 4-2 
four-button 4-4 
GIN 4-2 
one-button 4-3 
segments used as 4-2 
stylus 3-24, 4-3 


DA2INDEX 6-24 
DABUFFER 6-24 
DACHARS 6-25 
DAENABLE 6-25 
DAINDEX 6-26 


DALINES 6-26 
DAMODE 6-27 
DAPOSITION 6-27 
DASURFACE 6-28 
data bits 6-53 
data resolution 
for hard copies (see HCDATARES) 
internal 1-2, 2-20 
DAVIS 6-29 
defaults 
factory 6-3 
power-up 2-23 
reset to factory 2-23, B-4 
DEFINE 6-30, F-9 
DEGAUSS/CONVERGE button 2-6 
DELETE 3-11, 6-32 
deleting a file 3-11 
delimiters, string 6-8 
destination devices 6-8 
device driver 3-14, 6-51 
device names 3-3, 6-8 
devices 
default 6-8 
destination 3-2, 6-8 
naming conventions 3-2, 6-8 
source 3-2, 6-8 
dialog area 2-15 to 2-17, 6-24 to 6-29 
color map for (see DASURFACE) 
enable/disable 6-25 
how to modify F-5 
visibility control 6-29 
width in characters (see DACHARS) 
writing mode 6-27 
dialog area writing mode 6-27 
dialog buffer 2-16, 6-24 
DIALOG key 2-15 
DIRECTORY 3-10, 6-32 
directory 
entries on a disk 3-10 
examples of 6-33 
how to generate 3-10, 6-32 
of a disk 3-10 
of a file 3-10 
to a disk file 3-10 
to a plotter 3-17 
to a printer 3-19 
disk drive 
basic description 3-5 
command summary 3-8 
indicator 2-5 
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disks, flexible 
backing up 3-6 
changing 3-9 
inserting and removing 3-6 
formatting 3-8 
handling and safety 3-6 
life expectancy 3-6 
write-protecting 3-7 
disks, information format on 3-8 
blocks 3-8 
directory entries 3-8 
sectors 3-8 
tracks 3-8 
disks, rigid 3-7 
DISMOUNT 3-9, 6-34 
display module 1-2, 1-4 
documentation, list of 1-1 
DUPLEX 6-34 
duplex modes 5-6, 6-34 


ECHO 6-35 
EDITCHARS 6-35, F-5 
end-of-file string 3-2, 5-3, 6-36 
end-of-line string 5-3, 6-37 
with directory to plotter 3-17 
with printer 3-19 
end-of-message characters 5-4, 6-37 
in GIN reports 6-60 
EOFSTRING 5-3, 6-36 
EOLSTRING 5-3, 6-37 
EOMCHARS 5-4, 6-37 
error codes A-2 
ANSI A-21 
TEK A-5 
ERRORLEVEL 6-38 
error queue 6-38 
errors 
ANSI A-21 
disk and 3PPI A-3 
disk system context A-3 
DMS transfer A-4 
during power-up sequence B-1 
fatal B-2 
in Setup commmands 6-9 
reporting of 1-5, B-1 
severity levels A-1 
TEK A-5 
Esc key 2-12 


escape sequence commands 6-2, C-1 


in Local mode C-2 
in Setup mode C-1 
summary of C-3 
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expand a macro 6-30 
extension, file 3-2, 6-9 
external clocking (see BAUDRATE) 


factory defaults 6-3 
reset to B-4 
fatal errors B-2 
features of terminal 1-4 
file 3-2 
file devices 3-3 
file extensions 6-9 
file header 3-2 
file names 3-2, 6-9 
file transfers 3-2 
command summary 3-3 
filtering, graphics input 6-67 
FIXUP 6-38 
FLAGGING 5-2, 6-39 
purpose of 5-2, 6-39 
flexible disks (see disks, flexible) 
FORMAT 3-9, 6-39 
formatting a disk 3-8 
examples of 3-9 
four-button cursor 4-4 
framing box 2-20, F-13 
framing mode 2-20 
front panel controls 2-1 
full duplex mode 5-6, 6-34 
function keys 2-18 
identifiers for DEFINE commands 6-30 


GAMODE 6-40 
GIN devices 4-1 
GIN mode 4-1 
examples of use F-21 
how to disable 6-41 
how to enable 6-42 
overview 4-1 
using a plotter 4-4 
using a tablet 4-3 
GINAREA 6-40 
GINCURSOR 6-41 
GINDISABLE 6-41 
GINENABLE 6-42 
GINGRIDDING 6-42 
GININKING 6-43 
GINPICKAPERTURE 6-43 
GINRUBBERBAND 6-44 
GINSTARTPOINT 6-44 
GINWINDOW 6-45 
graphics area 1-4 
graphics area writing mode 6-40 


INDEX 


graphics input 
cursor 6-41 
examples of F-21 
Graphics Input mode (see GIN mode) 
graphics segment 1-5 
graphics surface 1-4, 6-18 
graphics tablet 
active writing area 4-3, 6-68 
attaching the tablet 3-23 
cleaning the tablet 3-24 
command summary 3-23 
cursors 4-3 
restoring the bias 3-24 
setup command for tablet 3-23 
use in GIN mode 4-3 
gray level 6-18 
mapping from colors to gray scale 6-18 
gray mode, how to specify 6-20 
gridding (in GIN mode) 4-2, 6-42 


half duplex mode(s) 5-6, 6-34 
half duplex with Supervisor mode 5-6 
HARD COPY key 2-18, 3-20, 3-22 
hard copy image orientation 6-47 
hard copy interface 3-20, 6-46 
hard copy 
background parameter (see COPY) 
color 3-20 
how to make 3-21, 3-22, 6-45 
monochrome copies 3-22 
monochrome copies via color interface 3-20 
reverse video 3-21, 3-22 
hard copy unit (monochrome) 3-22 
HCCOPIES 3-20, 6-45 
HCDATARES 3-20, 6-46 
HCINTERFACE 3-20, 6-46 
HCORIENT 3-20, 6-47 
header characters (for tablet) 6-67 
HLS color system 6-18 
host communications 
command summary 5-1 
overview 5-1 
host-to-plotter copy 3-18 


IGNOREDEL 6-47 

indicator lights, keyboard 2-8 
initializing the terminal F-1 
inking 4-1, 6-43 

input queue 5-3, 6-59 

int parameters D-3 


int-report parameters D-4 

integer parameter type 6-7 

INTENSITY control 2-6 | 
interrupting host with Break key 2-13, 5-3 


key execute delimiter 6-30, 6-48 
key specifiers 6-7 

for DEFINE 6-30 
keyboard 1-6, 2-8 

optional keyboards E-1 to E-6 
KEYBOARD connector 2-6 
KEYEXCHAR 6-48 
keywords 6-8 
KYBD LOCK indicator light 2-8 


LFCR 6-48 
line continue characters (Block mode) 5-5, 6-12 
line delete character 6-9, 6-35 
Line Feed key 2-11 
line feed implies carriage return 6-48 
literal character 6-7, 6-35 
examples of use 6-31, F-9 
LOAD 3-13, 6-49 | 
with disk files 3-13 
local echo 6-35 
local graphics, examples of F-10 
LOCAL key 2-17 
Local mode 1-5, 2-17 
local programmability 6-50 
locate function 4-1 
locked keyboard 2-8, 6-49 
LOCKKEYBOARD 6-49 
LPOS 6-50 


machine RGB color system 6-18 
macro 2-18, 6-30 
macro-identifier 6-30 
manual overview 1-1 
Mass Storage Interface 3-7 
master characters (block mode) 5-6, 6-15 
MASTER RESET button 2-4, B-3 
maximum line length 

for commands 6-8 © 

in Block mode 6-14 
“Memory” notation 6-10 


NEXT VIEW key 2-22 

non-transmittable characters (Block mode) 5-6, 6-15 
NORMAL key 2-21 

Normal (Half Duplex) mode 6-34 
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one-button cursor 4-3 
Opaque color mode 6-20 
op-code 6-2, C-1 
option list for terminal 1-3 
Overstrike mode 

in dialog area 6-27 

in graphics area 6-40 
OVERVIEW key 2-21 


packing values (Block mode) 5-6, 6-16 
page full condition 2-8, 6-50 
PAGE FULL indicator light 2-8 
Page key 2-14 
PAGEFULL 6-50 
PAN key 2-21 
parameter types 
in Setup commands 6-7 
parameters (for escape sequences) 
char D-2 
int D-3 
int-report D-4 
xy D-5 
xy-report D-6 
parameters (for Setup commands) 
defaults if omitted (see command descriptions) 
factory defaults 6-3 
how to specify omitted parameters 6-10 
types of 6-7 
PARITY 5-2, 6-51 
parity 5-2, 6-51 
parity checking 6-51 
PASSIGN 3-14, 6-51 
PBAUD 3-15, 6-52 
PBITS 3-15, 6-53 
PCOPY 3-15, 6-53 
pedestal 1-6 
PEOF 3-15, 6-54 
PEOL 3-15, 6-55 
peripheral port (See port) 
PFLAG 3-15, 6-55 
pick function 4-1 
PLOT 3-15, 6-56 
plotter 
4662 settings 3-15, 3-16 
4663 settings 3-16 
device driver settings (see PASSIGN) 
directory to 3-17 
host-to-plotter copy 3-18 
port settings 3-16 
set-up information 3-15 
use in GIN mode 4-4 
use of PLOT command 3-17 
use of SPOOL command 3-17 
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plotter pen color assignments 6-56 
PMAP 6-56 
port commands, summary of 3-15 
port flagging 6-55 
port-end-of-file string 6-54 
port-end-of-line string 6-55 
port-to-port copy 6-53 
POWER switch 2-1 
power-up defaults 2-3 
power-up sequence 2-2, B-1 
errors during B-1 
PPARITY 3-15, 6-57 
PPORT device driver 3-14 
precision grid 3-24 
printer 
4641 settings 3-19 
4643 settings 3-18 
directory to 3-19 
end-of-line string 3-19 
port settings 3-18 
set-up information 3-18 
spooling to 3-19 
printing characters 2-10 
programming a key, examples of F-9 
Prompt mode 5-4, 6-57 
prompt string 5-4, 6-58 
PROMPTMODE 5-4, 6-57 
PROMPTSTRING 5-4, 6-58 
PROTECT 3-11, 6-58 
protecting a file 3-11, 6-58 


QUEUESIZE 5-3, 6-59 


RCV indicator light 2-8 
real parameter type 6-7 
Replace mode 
in dialog area 6-27 
in graphics area 6-40 
related documentation 1-1 
remote echo 6-35 
RENAME 3-11, 6-59 
renaming a file 3-11 
RENEW 6-60 
REOM 6-60 
reports 
end-of-message indicator 6-60 
line length in 6-61 
signature characters 6-61 
RESTORE key 2-22 
reverse video hard copy 3-21, 3-22 
RGB color system 6-18 
RGB, machine 6-18 
RLINELENGTH 6-61 


INDEX 


Rtn key 2-12 
RSIGCHARS 6-61 

Rub Out key 2-11 
rubberbanding 4-1, 6-44 


SAVE 3-13, 6-62 
examples of F-19, F-20 
to a plotter 3-17 
with disk files 3-13 
sectors, disk 3-8 
segment 1-5 
used as GIN cursor 4-2 
examples of manipulations F-12 
Self Test 2-5, B-2 
SELF TEST button 2-5, B-3 
SET UP key 2-15, 6-1 
Setup mode 2-15, 6-1 
interactions with other modes & settings 6-2 
setup commands 6-1 
correcting errors in 6-9 
factory defaults (in Table 6-1) 6-3 
parameter types 6-7 
summary of 6-3 to 6-6 
syntax conventions 6-10 
setup memory 2-3, 6-2 
reset to defaults B-4, F-3 
saved parameters 6-3 
severity levels, error 6-38, A-1 
Shift key 2-12 
signature characters 6-61 
single character parameter type 6-7 
SNOOPY 6-63 
software support 1-2 
source devices 6-8 
Space 
in Overstrike mode 6-27, 6-40 
in Replace mode 6-27, 6-40 
SPOOL 3-13, 6-63 
to acolor copier 3-21 
to a plotter 3-17 
to a printer 3-19 
STATUS 6-64, F-5 
STATUS COMMUNICATIONS F-6 
_ STATUS EDITCHARS F-5 
STOP 6-66 
stop bits 5-4, 6-66 
for peripheral ports 6-53 
STOPBITS 5-4, 6-66 
string delimiters 6-8 
string parameter type 
delimited 6-8 
undelimited 6-8 
stroke function 4-2 
stylus 3-24, 4-3 
submessages in self test B-3 


substitute character 5-6 
Subtractive color mode 6-20 
supersurface 6-18 
Supervisor (Half Duples) mode 5-6, 6-34 
syntax of escape sequence commands 
in Local mode C-2 
in Setup mode C-1 
syntax of Setup commands 6-10 


Tab key 2-12 
tablet, graphics (see graphics tablet) 
tape drive, use of 3-20 
TBFILTER 3-23, 6-67 
TBHEADERCHARS 3-23, 6-67 
TBSIZE 3-23, 6-68 
TBSTATUS 3-23, 6-68 
TEK mode 6-21 
TEK mode errors A-5 
Three-Port Peripheral Interface 
command summary 3-15 
description 3-14 
thumbwheels 2-8 
use in Framing mode 2-21, F-12 
use in GIN mode 4-2 
use in scrolling text F-7 
time out (Block mode) 5-6, 6-17 
tracks, disk 3-8 
transmit delay 5-3, 6-69 
transmit limit 5-3, 6-70 
turnaround time 5-3 


Underscore with DAMODE 6-27 
user number 3-9, 6-69 
USERNUMBER 32-9, 6-69 


vernier action 2-21 

view 1-5 

VIEW key 2-20 

viewing keys 1-7, 2-20 
examples of use F-12 to F-18 

viewport 2-20 

viewport update 6-60 


WRITE PROTECT switches 2-5, 3-7 
WRITE PROTECT indicators 2-5 
write-protecting a disk 3-7 
write-protecting a file 3-11, 6-58 


XMT indicator light 2-8 
XMTDELAY 5-3, 6-69 
XMTLIMIT 5-3, 6-70 

xy parameters D-5 
xy-report parameters D-6 


ZOOM key 2-21 


4115B OPERATORS 


